Be nice... be fair! Writing free Open Source software often means spending time developing after-hours, and in weekends. Chances are pretty good that you yourself are involved in one or many Open Source projects and already know how time-consuming it can be. In any case, the following constitutes the code of conduct used by Ion:
Be patient, nice and fair.
Be helpful and constructive.
Your words and actions must be free of harassment, harmful deeds or remarks, and malicious intent.
Respect the opinions of others, even if they contradict yours.
Participants can be subject to consequences, if the code of conduct is not upheld. Such consequences include, but not limited to, warnings, and banning from further participation.
Have you found a defect ( bug or design flawopen in new window ), or do you wish improvements? In the following sections, you might find some useful information on how you can help this project. In any case, I thank you for taking the time to help me improve this project's deliverables and overall quality.
If you have an idea for a new feature or perhaps changing an existing, feel free to create a feature requestopen in new window. Should you feel unsure whether your idea is good or not, then perhaps you could start a discussionopen in new window.
As soon as I receive the pull-request (and have time for it), I will review your changes and merge them into this project. If not, I will inform you why I choose not to.
Ion is still in development. You SHOULD NOT use any of the packages in a production environment. Breaking changes MUST be expected for all v0.x releases!
The meta decorator is able to associate arbitrary metadata with a class and its elements.
import{meta, getMeta}from'@aedart/support/meta';
+
+@meta('description','Able to search for locations')
+classService{}
+
+getMeta(Service,'description');// Able to search for locations
+
A package intended to contain various helpers and utilities. At the moment, the package comes with a few object utilities. See package documentation for more details.
Utilities for vuepress sites, which includes an Archive component for structuring documentation into an archive. See package documentation for details.
For many years, I was too discouraged and overburden to publish my JavaScript as packages. Having a full-time job and maintaining Athenaeumopen in new window took most of my time. Like so many other developers, I was copying JavaScript from one project into another. I always knew that was very bad practice. But, it was too cumbersome trying to maintain so much code, spread throughout various repositories.
Sometimes, documentation might be available for a package that has not yet been released. Usually it is tagged with a Not Released badge, unless the package documentation is located in "next" release".
In rare situations, a package might only exist in the mono-repository and not published to npm's registry. Such a package is either experimental or internal, which means that it might not ever be published. Usually, it will be tagged with Internal (not published)Experimental, or similar badges, if documentation is made available about the package!
+
+
+
diff --git a/archive/current/packages/support/arrays/includesAll.html b/archive/current/packages/support/arrays/includesAll.html
new file mode 100644
index 00000000..5668fa34
--- /dev/null
+++ b/archive/current/packages/support/arrays/includesAll.html
@@ -0,0 +1,43 @@
+
+
+
+
+
+
+
+
+ Includes All | Ion
+
+
+
+
+
+
const a ={foo:'foo'};
+const b ={bar:'bar'};
+const c ={ping:'pong'};
+
+const result =merge([ a ],[ b, c ]);
+
+console.log(result[0]=== a);// false
+console.log(result[1]=== b);// false
+console.log(result[2]=== c);// false
+
In this context, an "alias" is a proxy property or method inside a target class. It is responsible for forwarding interaction to the original property or method, inside the concern class instance. Aliases are created automatically by the use() class decorator.
When injecting a concern into a target class, the concern's public properties and methods are defined as "aliases" (aka. proxy properties or methods), in the target class' prototype (see PROVIDES symbol for additional details).
When a property or method from a concern already exists in the target class' prototype chain¹, then NO Alias is defined. Said differently, the use() class decorator does NOT overwrite a target class' properties or methods.
By default, a concern class is ONLY instantiated when you interact with its properties or methods, which have been "aliased" into a target class (aka. lazy bootingopen in new window).
classContactsApiextendsAbstractConcern{
+ getusers(){/* ...not shown here... */}
+}
+
+@use(ContactsApi)// Concern is NOT instantiated
+classUsersRegistry{}
+
+const users =(newUsersRegistry()).users;// Concern is instantiated
+
By default, all the public properties and methods (all property keys) are made available for "aliasing" into a target class. To configure which members should be made available for aliasing, see Customise "alias" members.
Static methods and properties are NOT "aliased" into target class.
At the moment, such a feature is not supported by the concerns' mechanism.This may become available in the future, but presently you SHOULD NOT rely on static members becoming available for aliasing.
When this happens, properties cannot be "aliased". The concern mechanisms relies on the class' prototype for reading what properties are available. To overcome such an issue, you can use gettersopen in new window and settersopen in new window instead.
If you wish to customise what properties and methods should be available for aliasing when used by a target class, overwrite the static PROVIDES method.
Even if you do customise what properties and methods are available for aliasing, the returned property keys of the PROVIDES method can be overruled, via conflict resolution!
If you truly wish to prevent certain properties or methods from being aliased into a target class, then you should declare them as privateopen in new window.
The concernOwner property gives you direct access to the target class instance, in your concern. This allows you to create interaction between the target instance and your concern, which can be usefully in any number of situations. For instance, you can use the concernOwner to create a fluent designopen in new window of your utilities.
Should you require initialisation logic, then you can overwrite the constructor in your concern class. A concern's constructor is only given the target class instance as argument.
A concern class may ONLY occur once in a target class' prototype chain. This is a core feature of the concerns mechanism and cannot be circumvented. However, sometimes you may find yourself in situations where different injected concern classes define the same property or method name. When this happens an AliasConflictError is thrown.
You can also use a shorthand version to specify a concern injection configuration, via an array. The first array value must always be the concern class that must be injected. The second value can either be an aliases object, or boolean value for setting the allowAliases option.
It is not possible to define a property's getter and setter methods in separate concerns, and thereafter use them in a target class. Despite serving different purposes, the getter and setter share the same property name and are therefore treated as being one and the same property key. The following example will therefore always lead to an AliasConflictError being thrown.
You can resolve the above shown issue via a custom alias. But, it is advisable to design your concerns such that the offer appropriate getter and setter methods for a property, in one and the same concern - if you intend for such a property to be readable and writable.
The concerns mechanism will never overwrite existing methods or properties inside a target class - not even when those methods or properties are inherited from a parent class.
import{ AbstractConcern, use }from"@aedart/support/concerns";
+
+classConnectionextendsAbstractConcern{
+ driver(){
+ return'special';
+ }
+}
+
+classApi{
+ driver(){
+ return'default';
+ }
+}
+
+@user(Connection)// driver() is NOT aliased - method inherited from Api class!
+classSailBoatextendsApi{}
+
+const instance =newSailBoat();
+instance.driver();// default
+
The only way to resolve the above shown issue, is by making use of a custom alias and manually overwrite the inherited method. E.g.
In some isolated cases, this might be acceptable for you. Nevertheless, if your application makes heavy use of concerns using other concerns, then your application's overall performance could suffer. You should consider merging multiple concern classes into a single class, if it is reasonable and possible. Alternatively, you can also consider extending existing concern classes. For instance:
To perform pre-registration logic, use the static BEFORE method in your concern class. This hook method is invoked before the concern container and aliases are defined in the target class.
The method accepts the following arguments:
target: UsesConcerns - the target class (class constructor!).
import{BEFORE}from"@aedart/contracts/support/concerns";
+import{ AbstractConcern }from"@aedart/support/concerns";
+import{ isSubclass }from'@aedart/support/reflections';
+
+import{ JobHandler }from'@acme/jobs';
+
+classRecordsJobsextendsAbstractConcern{
+
+ static[BEFORE](target){
+ // E.g. prevent this concern from being used by all kinds of targets...
+ if(!isSubclass(target, JobHandler)){
+ thrownewTypeError('RecordsJobs can only be used by JobHandler');
+ }
+ }
+}
+
To perform post-registration logic, use the static AFTER method in your concern class. This method is invoked after the concern container and aliases have been defined in target's prototype.
The method accepts the following arguments:
target: UsesConcerns - the target class (class constructor!).
In this context, a "concern" is a class that can be injected into a target class, by means of the use() class decorator. The public properties and methods of the concern class are then "aliased" into the target class' prototype. In other words, "proxy" properties and methods are defined in the target class. They forward any interaction to the original properties and methods in the concern class instance.
import{ use, AbstractConcern }from"@aedart/support/concerns";
+
+// A concern class...
+classConsolePrinterextendsAbstractConcern{
+ print(message){
+ console.log(message);
+ }
+}
+
+// Taget class that uses a concern...
+@use(ConsolePrinter)
+classPerson{
+
+ sayHi(name){
+ // Call method in concern
+ this.print(`Hi ${name}`);
+ }
+}
+
+// Later in your application...
+const person =newPerson();
+person.sayHi('Atrid');// Hi Astrid
+
+person.print('Ho ho ho...');// Ho ho ho...
+
Most modern IDEs support JSDocopen in new window. They can improve your coding experience via code suggestions, highlights and other features. In this chapter, you will find a few ways that you can document your concerns and target class, via JSDoc.
Help wanted!
If you are an expert in JSDoc, then you are most welcome to help improve this chapter. Please see the contribution guide for details on how you can contribute.
Possibly the easiest way to document your concern and target class that uses the concern, is via the @mixin and @mixesopen in new window tags.
Downside: Documenting "aliases" (known as virtual fields in the context of JSDoc) is not possible via @mixin and @mixes. You can describe an alias via @functionopen in new window or @memberopen in new window tag.
Another possibility is to describe properties and methods available in a target, via the @propertyopen in new window tag. Doing so allows you to immediately describe the "alias" name.
Downside: Properties and methods described via @property are listed as "static" on the target class. Also, it is not possible to reuse existing JSDoc from your concern.
When concern classes are injected, the target class is transformed and all concerns are made available inside a private CONCERNS property. See Manual interaction and Aliases for additional details.
When concerns are injected into a target, they are defined inside a "Concerns Container", which is available in the target instance via the CONCERNS symbol. Should you require to perform more advanced interaction with a concern class instance, then you can obtain a concern instance via the container's get() method. It will automatically ensure to boot a concern, if not already booted.
CONCERNS symbol, getContainer(), and getConcernsContainer()
There are 3 ways to obtain the concerns container instance:
A) CONCERNS symbol
Inside your target class, if you know that concerns are used (if target is a "concern owner"), then you can use the CONCERNS symbol to gain access to the container.
The getConcernsContainer() achieves the same result as the previous shown methods. However, it does perform a check of the provided target instance, which ensures that it is a "concern owner". If the target does not pass this test, then a TypeError is thrown. This might can be useful in situations when you might now know if the target is a concern owner, e.g. when situated in a child class or outside a target class.
The stack is not yet an official featureopen in new window, even though it's supported by many major browsers and Node.js. If you are working with custom errors, you might not need to capture and set the stack property. Therefore, you should only use configureStackTrace() in situations when your JavaScript environment does not support stack traces in custom errors.
You can also overwrite the inherited metadata. The subclass that defines the metadata creates its own copy of the inherited metadata. The parent class' metadata remains untouched.
import{ meta, getMeta }from'@aedart/support/meta';
+
+classService{
+
+ @meta('search.desc','Searches for countries')
+ search(){
+ // ...not shown...
+ }
+}
+
+classCitySearcherextendsService{
+
+ @meta('search.desc','Searches for cities')
+ search(){
+ // ...not shown...
+ }
+}
+
+const service =newCitySearcher();
+
+getMeta(CitySearcher,'search.desc');// Searches for cities
+getMeta(Service,'search.desc');// Searches for countries
+
Whenever you read metadata, a copy is returned by the getMeta() method. This means that you can change the data, in your given context, but the original metadata remains the same.
Only the meta decorator is intended to alter existing metadata - even if the value is an object. Please be mindful of this behaviour, whenever you change retrieved metadata using the getMeta() and getAllMeta() methods.
Depending on the kind of element that is decorated, metadata might only become available for reading, after a new class instance has been instantiated. This is true for the following elements:
method
getter
setter
field
accessor
Static Elements
If an element is declared as staticopen in new window, then it's metadata becomes available as soon as the class has been defined.
If you need to create more advanced metadata, you can specify a callback as the first argument for the meta() decorator method. When using a callback you gain access to the target that is being decorated, as well as the decorator context. The callback MUST return an object that contains a key and a value property.
Although the above example is a bit cumbersome to read, it shows a simple way to defined metadata for a method, which utilises the decorator context. If you wish, you can use this approach to create your own specialised meta decorators. Doing so can also improve the readability of your class. Consider the following example:
The targetMeta() decorator offers the ability to associate metadata directly with a class instance or class method reference. This can be useful in situations when you do not know the class that owns the metadata.
Behind the scene, targetMeta() uses the meta() decorator and stores a reference to the target that is decorated inside a WeakMapopen in new window.
Inheritance for static methods works a bit differently. By default, any subclass will automatically inherit target metadata, even for static methods. However, if you overwrite the given static method, the metadata is lost.
Limitation
When a static method is overwritten, the parent's "target" metadata cannot be obtained due to a general limitation of the meta() decorator. The decorator has no late this binding available to the overwritten static method. This makes it impossible to associate the overwritten static method with metadata from the parent.
Example: inheritance for static methods
import{targetMeta, getTargetMeta}from'@aedart/support/meta';
+
+classService{
+
+ @targetMeta('dependencies',['xmlClient'])
+ staticsearch(client){
+ // ...not shown...
+ }
+}
+
+classCountrySearcherextendsService{
+ // ... not method overwrite here...
+}
+
+classCitySearcherextendsService{
+
+ // Overwite of static method - target meta is lost
+ staticsearch(client){}
+}
+
+// ...later in your application...
+getTargetMeta(CountrySearcher.search,'dependencies');// [ 'xmlClient' ]
+getTargetMeta(CitySearcher.search,'dependencies');// undefined
+
To overcome the above shown issue, you can use the inheritTargetMeta() decorator. It forces the static method to "copy" metadata from its parent, if available.
In relation to the Decorator Metadata proposalopen in new window, this decorator "mimics" a similar behaviour as the one defined by the proposal. Defining and retrieving metadata relies on a decorator's context.metadata object, and the Symbol.metadata property of a class.
(Above shown example is very simplified. Actual implementation is a bit more complex...)
At present, the internal mechanisms of the meta decorator must rely on a WeakMapopen in new window to associate metadata with the intended class. When the Decorator Metadata proposalopen in new window becomes more mature and transpilers offer the context.metadata object (or when browsers support it), then this decorator will be updated respectfully to use the available metadata object.
+
+
+
diff --git a/archive/current/packages/support/misc/descTag.html b/archive/current/packages/support/misc/descTag.html
new file mode 100644
index 00000000..7b9ac0ff
--- /dev/null
+++ b/archive/current/packages/support/misc/descTag.html
@@ -0,0 +1,45 @@
+
+
+
+
+
+
+
+
+ Desc. Tag | Ion
+
+
+
+
+
+
Wraps a target object into a WeakRefopen in new window, if not already instance of a weak reference.
import{ toWeakRef }from"@aedart/support/misc";
+
+const person ={name:'Sine'};
+
+const a =toWeakRef(person);// new WeakRef of "person"
+const b =toWeakRef(a);// same WeakRef instance as "a"
+
+toWeakRef(null);// undefined
+toWeakRef(undefined);// undefined
+
You can use the Mixin decorator to define a new mixin. Amongst other things, the decorator will enable support for instanceofopen in new window checks. See instanceof Operator for additional information.
If you need to perform initialisation logic in your mixins, then you can do so by implementing a class constructoropen in new window. When doing so, it is important to invoke the parent constructor via super()open in new window and pass on eventual arguments.
import{ Mixin }from"@aedart/support/mixins";
+
+exportconst RectangleMixin =Mixin((superclass)=>classextends superclass {
+
+ constructor(...args){
+ super(...args);// Invoke parent constructor and pass on arugments!
+
+ // Perform your initialisaiton logic...
+ }
+
+ // ...remaining not shown...
+});
+
Determines if given object is "cloneable". In this context "cloneable" means that an object implements the Cloneable interface, and offers a clone() method.
See @aedart/constracts/support/objects/Cloneable for details.
Determines if given object is "populatable". Here, "populatable" means that an object implements the Populatable interface, and offers a populate() method.
See @aedart/constracts/support/objects/Populatable for details.
Determine if paths are properties of given object and have values. This method differs from has(), in that it only returns true if properties' values are not undefined and not null.
keys: PropertyKey | PropertyKey[] | SourceKeysCallback = '*' - The keys to select and copy from source object. If wildcard (*) given, then all properties from the source are selected. If a callback is given, then that callback must return key or keys to select from source.
safe: boolean = true - When true, properties must exist in target (must be defined in target), before they are shallow copied.
By default, all keys (*) from the source object are attempted populated into the target. You can limit what properties can be populated, by specifying what keys are allowed to be populated.
¹: In this context, the returned number is unique in the current session. The number will NOT be unique across multiple sessions, nor guarantee that an object will receive the exact same identifier as in a previous session!
The class "blueprint" is an object that defines the expected members (property keys) of a target class. All defined members must exist in target class' prototype, before the classLooksLike() returns true.
You can specify either or both of the following properties in a class blueprint object:
members: PropertyKey[] - (optional) Properties or methods expected to exist in class' prototype.
staticMembers: PropertyKey[] - (optional) Properties or methods expected to exist in class as static members.
Note:If you do not specify either members or staticMembers, then a TypeError is thrown.
classLooksLike() traverses target class' prototype chain. This means that you can compare a subclass against a blueprint and inherited members will automatically be included in the check.
target: ConstructorOrAbstractConstructor - The target class.
recursive: boolean = false - (optional) If true, then target's parent prototypes are traversed. Descriptors are merged, such that the top-most class' descriptors are returned.
Behind the scene, the isKeyUnsafe() function matches the given key against values from the predefined DANGEROUS_PROPERTIES list, which is defined in the @aedart/contracts/support/objects submodule;
The <VersionDisclaimer /> component is a simply "notice" container, which can be used in your layout. Most often, you would use this to display a custom message when outdated / unsupported documentation is being viewed.
<VersionDisclaimertype="warning"label="Note">
+ You are viewing documentation for an unsupported version...
+</VersionDisclaimer>
+
The following example assumes that you are using an Archive component to structure documentation. When doing so, you can display a custom message whenever "outdated" or "upcoming" documentation is being viewed.
To achieve this, you will need to create a custom layoutopen in new window (e.g. extend the default theme). Create a new layout, e.g. in .vuepress/layouts/Layout.vue.
<scriptsetuplang="ts">
+import ParentLayout from'@vuepress/theme-default/layouts/Layout.vue';
+import VersionDisclaimer from"@aedart/vuepress-utils/components/VersionDisclaimer.vue";
+import{usePageData}from"@vuepress/client";
+import{isViewingNextRef, isViewingOtherRef}from"@aedart/vuepress-utils";
+import archive from"../my_archive";
+
+const page =usePageData();
+const showForNext =isViewingNextRef(page, archive);
+const showForOther =isViewingOtherRef(page, archive);
+</script>
+
+<template>
+ <ParentLayout>
+ <template#page-top>
+
+ <VersionDisclaimerv-if="showForNext">
+ You are viewing documentation for next version...
+ </VersionDisclaimer>
+
+ <VersionDisclaimerv-if="showForOther"type="danger"label="Oh oh">
+ You are viewing old stuff...
+ </VersionDisclaimer>
+
+ </template>
+ </ParentLayout>
+</template>
+
The isViewingNextRef() method returns a computed property that indicates if visitor is viewing the "next" collection of pages. The isViewingOtherRef() methods returns a computed property that determines if pages are viewed that do not belong to "next" nor "current" collections.
The Archive component is a helper that keeps track of collections of pages in an "archive" (exactly like this site). It operates on the notion that there is always a "current" and "next" collection of pages. It can be used to structure documentation for various versions of your application, components, packages...etc.
The following illustrates a possible archive structure of your documentation. Notice the "current" and "next" directories. These two directories are essential for the Archive component. Their names can be configured (shown later). Each of the directories contains a collection of pages.
Each Archive component is dependent on having its structure defined by means of PagesCollection components. As such, to represent the "current" collection, you must create a new PagesCollection instance. Use the static make() method to create a new instance. It accepts 3 arguments:
name: string Name or title of the collection.
path: string The relative path in the archive to the collection.
pages: SidebarConfigArray = [] An array of pages or group of pages. Each page's path is relative to the collection's path.
The path argument of a pages collection will automatically be changed, by the Archive component, if the collection is marked as the "current" or "next" collection (covered in next section).
Once you have your "current" and "next" collections defined, you can create a new Archive instance. Use the static make() method to create a new instance. It accepts 3 arguments:
current: PagesCollection The collection to be marked as the "current".
next: PagesCollection The collection to be marked as the "next".
collections: PagesCollection[] = [] Array of all available collections, including "next" and "current".
// E.g. inside /.vuepress/my_archive/index.ts
+import{PagesCollection}from"@aedart/vuepress-utils/contracts";
+import{Archive}from"@aedart/vuepress-utils/navigation";
+import v3x from"./v3x.ts";
+import v4x from"./v4x.ts";
+import v5x from"./v5x.ts";
+import v6x from"./v6x.ts";
+
+// Defined the "current" colelction
+constCURRENT: PagesCollection = v5x;
+
+// Defined the "next" colelction
+constNEXT: PagesCollection = v6x;
+
+// Define all collections... next and current should also be part of this...
+constALL: PagesCollection[]=[
+ NEXT,
+ CURRENT,
+ v4x,
+ v3x,
+ // ... etc
+];
+
+// Finally, create and export your archive with "current" and "next"
+const archive = Archive.make(CURRENT,NEXT,ALL);
+archive.path ='/my_archive';
+
+exportdefault archive;
+
Whenever a collection is marked as "current" or "next", its path is automatically changed to /current or /next. This means that the full path of those collections will be the archive's path + current or next, e.g.
/archive/current
/archive/next
To change these paths, specify the currentPath and nextPath properties in your Archive instance.
When you change the "current" and "next" paths in your archive, then the directory structure MUST reflect these names. From the above example, the archive's directory structure should now be the following:
To put it all together, in your Config Fileopen in new window, import your archive instance. Inside your theme settings, you can create a dropdown representation of your archive, by invoking the asNavigationItem() method. A sidebar configuration can be created via the sidebarConfiguration() method.
@aedart/xyz is an internal package that is used for experiments, e.g. tinkering with decorators, proxies, or whatever might be "fun" to try out. The package is NOT published, nor is it intended to ever be published.
If you have discovered a vulnerability, please send an encrypted email to Alin Eugen Deac (aedart@gmail.com). Use the public PGP key listed below for encryption. Your email will be prioritised and addressed as quickly as possible.
In addition, please make sure that the contents of your email contains appropriate information about the vulnerability. E.g.:
Where the vulnerability is located
Why it is a vulnerability
Affected version(s)
(How it can be resolved, if you have a possible solution)
How to encrypt emails using PGP
If you do not know how to use PGP encryption, then the following can help you
The util functions targetMeta() and inheritTargetMeta() now throw a MetaError instead of previous TypeError. If you rely on TypeError as the type of exception being thrown in a try-catch statement, when decorating class members, then you should change it to MetaError.
Various metadata related type definitions have now been deprecated in favour of TypeScript's own definitions. Mostly, this should not affect the implementation. However, if your decorator(s) depend on the following types (see below), then you are strongly encouraged to use corresponding TypeScript defined types instead.
Deprecated types and interfaces are defined in @aedart/contracts/support/meta:
ClassContext
MethodContext
GetterContext
SetterContext
FieldContext
AccessorContext
MetadataContext
MemberContext
More information available in the source code and CHANGELOG.md
The @aedart/vuepress-utils has been upgraded to use vuepress v2.0.0-rc.2, meaning that you no longer should require to manually define your vuepress dependency, in your application's packages.json file.
forgetAll(), hasAll() and hasAny() (in @aedart/support/object submodule) now accept rest parameters instead of an array of paths. If you are using these methods, then you need to upgrade or risk unexpected results.
When a property or method from a concern already exists in the target class' prototype chain¹, then NO Alias is defined. Said differently, the use() class decorator does NOT overwrite a target class' properties or methods.
¹: Inherited properties and methods are also respected.
',4),d={};var k=(0,a(6262).A)(d,[["render",function(n,s){const a=(0,e.g2)("router-link"),d=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,p,(0,e.Lk)("nav",o,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#properties-methods"},{default:(0,e.k6)((()=>[(0,e.eW)("Properties & Methods")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#if-property-or-method-already-exists"},{default:(0,e.k6)((()=>[(0,e.eW)("If property or method already exists")])),_:1})])])]),c,(0,e.Lk)("p",null,[(0,e.eW)('When injecting a concern into a target class, the concern\'s public properties and methods are defined as "aliases" ('),l,(0,e.eW)("), in the target class' prototype ("),(0,e.Lk)("em",null,[(0,e.eW)("see "),(0,e.bF)(d,{to:"/archive/current/packages/support/concerns/concernClass.html#customise-alias-members"},{default:(0,e.k6)((()=>[i,(0,e.eW)(" symbol")])),_:1}),(0,e.eW)(" for additional details")]),(0,e.eW)(").")]),u,(0,e.Lk)("p",null,[(0,e.eW)("See "),(0,e.bF)(d,{to:"/archive/current/packages/support/concerns/usage.html#manual-interaction"},{default:(0,e.k6)((()=>[(0,e.eW)("Manual interaction")])),_:1}),(0,e.eW)(" and "),(0,e.bF)(d,{to:"/archive/current/packages/support/concerns/conflictResolution.html"},{default:(0,e.k6)((()=>[(0,e.eW)("Conflict Resolution")])),_:1}),(0,e.eW)(" for additional details.")]),r,(0,e.Lk)("p",null,[(0,e.eW)("See "),(0,e.bF)(d,{to:"/archive/current/packages/support/concerns/conflictResolution.html"},{default:(0,e.k6)((()=>[(0,e.eW)("Conflict Resolution")])),_:1}),(0,e.eW)(" for additional details.")])])}]]);const m=JSON.parse('{"path":"/archive/current/packages/support/concerns/aliases.html","title":"Aliases","lang":"en-GB","frontmatter":{"title":"Aliases","description":"What are aliases","sidebarDepth":0},"headers":[{"level":2,"title":"Properties & Methods","slug":"properties-methods","link":"#properties-methods","children":[]},{"level":2,"title":"If property or method already exists","slug":"if-property-or-method-already-exists","link":"#if-property-or-method-already-exists","children":[]}],"git":{"updatedTime":1709641376000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/concerns/aliases.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/app.8f7791e3.js b/assets/js/app.8f7791e3.js
new file mode 100644
index 00000000..b1ca44ed
--- /dev/null
+++ b/assets/js/app.8f7791e3.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3524],{2090:function(e,t,r){r.d(t,{B:function(){return I}});var a=r(6358),s=r(3825),i=r(3450),l=r(5436),c=r(1599),n=r(5496),o=r(443),p=r(355),u=r(8973),h=r(641),d=r(953),g=r(3567),m=r(33),k=(0,h.pM)({name:"VersionDisclaimer",props:{type:{type:String,default:"info"},label:{type:String}},setup(e){const t=e.type,r=e.label;return{css:(0,h.EW)((()=>({"version-disclaimer":!0,[t]:!0}))),label:(0,h.EW)((()=>r||t.charAt(0).toUpperCase()+t.slice(1))),type:t}}}),v=(0,r(6262).A)(k,[["render",function(e,t,r,a,s,i){return(0,h.uX)(),(0,h.CE)("div",{class:(0,m.C4)(e.css)},[(0,h.Lk)("label",null,(0,m.v_)(e.label),1),(0,h.RG)(e.$slots,"default")],2)}]]),b=r(3456);function f(e,t){return t.startsWith("/")||(t="/"+t),(e+t).replaceAll("//","/")}function x(e,t){const r=t.nextFullPath;return e.value.path.startsWith(r)}class y{_name;_path;_archive=null;pages;constructor(e,t,r=[]){this._name=e,this._path=t,this.pages=r}static make(e,t,r=[]){return new this(e,t,r)}set name(e){this._name=e}get name(){return this._name}set path(e){this._path=e}get path(){return this._path}get fullPath(){return this.prefixWithArchivePath(this.path)}set archive(e){this._archive=e}get archive(){return this._archive}asNavigationItem(){return{text:this.name,link:this.fullPath}}asSidebarObject(){return{[this.fullPath]:this.sidebar()}}sidebar(){return this.resolvePages(this.pages)}resolvePages(e){return e.forEach(((e,t,r)=>{r[t]=this.resolvePage(e)})),e}resolvePage(e){return"string"==typeof e?this.prefixWillFullPath(e):Reflect.has(e,"children")&&0!==e.children.length?(e.children.forEach(((e,t,r)=>{r[t]=this.resolvePage(e)})),e):e}prefixWillFullPath(e){return f(this.fullPath,e)}prefixWithArchivePath(e){return f(null!==this.archive?this.archive.path:"",e)}}const L=y.make("v0.x","/v0x",[{text:"Version 0.x",collapsible:!0,children:["","upgrade-guide","contribution-guide","security","code-of-conduct","origin"]},{text:"Packages",collapsible:!0,children:["packages/",{text:"Contracts",collapsible:!0,children:["packages/contracts/","packages/contracts/install"]},{text:"Support",collapsible:!0,children:["packages/support/","packages/support/install",{text:"Arrays",collapsible:!0,children:["packages/support/arrays/","packages/support/arrays/includesAll","packages/support/arrays/includesAny","packages/support/arrays/isArrayLike","packages/support/arrays/isConcatSpreadable","packages/support/arrays/isSafeArrayLike","packages/support/arrays/isTypedArray","packages/support/arrays/merge"]},{text:"Concerns",collapsible:!0,children:["packages/support/concerns/","packages/support/concerns/prerequisites","packages/support/concerns/concernClass","packages/support/concerns/usage","packages/support/concerns/aliases","packages/support/concerns/conflictResolution","packages/support/concerns/booting","packages/support/concerns/hooks","packages/support/concerns/edgeCases","packages/support/concerns/jsdoc"]},{text:"Exceptions",collapsible:!0,children:["packages/support/exceptions/","packages/support/exceptions/configureCustomError","packages/support/exceptions/configureStackTrace","packages/support/exceptions/getErrorMessage","packages/support/exceptions/customErrors"]},{text:"Meta",collapsible:!0,children:["packages/support/meta/","packages/support/meta/prerequisites","packages/support/meta/supported","packages/support/meta/setAndGet","packages/support/meta/inheritance","packages/support/meta/outsideChanges","packages/support/meta/tc39","packages/support/meta/targetMeta"]},{text:"Mixins",collapsible:!0,children:["packages/support/mixins/","packages/support/mixins/newMixin","packages/support/mixins/apply","packages/support/mixins/instanceof","packages/support/mixins/inheritance","packages/support/mixins/onward"]},{text:"Object",collapsible:!0,children:["packages/support/objects/","packages/support/objects/forget","packages/support/objects/forgetAll","packages/support/objects/get","packages/support/objects/has","packages/support/objects/hasAll","packages/support/objects/hasAny","packages/support/objects/hasUniqueId","packages/support/objects/isCloneable","packages/support/objects/isPopulatable","packages/support/objects/isset","packages/support/objects/merge","packages/support/objects/populate","packages/support/objects/set","packages/support/objects/uniqueId"]},{text:"Reflections",collapsible:!0,children:["packages/support/reflections/","packages/support/reflections/assertHasPrototypeProperty","packages/support/reflections/classLooksLike","packages/support/reflections/classOwnKeys","packages/support/reflections/getAllParentsOfClass","packages/support/reflections/getClassPropertyDescriptor","packages/support/reflections/getClassPropertyDescriptors","packages/support/reflections/getConstructorName","packages/support/reflections/getNameOrDesc","packages/support/reflections/getParentOfClass","packages/support/reflections/hasAllMethods","packages/support/reflections/hasMethod","packages/support/reflections/hasPrototypeProperty","packages/support/reflections/isConstructor","packages/support/reflections/isKeySafe","packages/support/reflections/isKeyUnsafe","packages/support/reflections/isSubclass","packages/support/reflections/isSubclassOrLooksLike","packages/support/reflections/isWeakKind"]},{text:"Misc",collapsible:!0,children:["packages/support/misc/","packages/support/misc/descTag","packages/support/misc/empty","packages/support/misc/isKey","packages/support/misc/isPrimitive","packages/support/misc/isPropertyKey","packages/support/misc/isset","packages/support/misc/mergeKeys","packages/support/misc/toWeakRef"]}]},{text:"Vuepress Utils",collapsible:!0,children:["packages/vuepress-utils/","packages/vuepress-utils/install",{text:"Navigation",collapsible:!0,children:["packages/vuepress-utils/navigation/archive"]},{text:"Plugins",collapsible:!0,children:["packages/vuepress-utils/plugins/last-updated"]},{text:"Components",collapsible:!0,children:["packages/vuepress-utils/components/version-disclaimer"]}]},"packages/xyz/"]}]),C=y.make("v1.x","/v1x",[{text:"Version 1.x",collapsible:!0,children:[""]}]),A=[C,L];var P=class{_name="Archive";_path="/archive";_current;_next;_collections=[];_currentLabel="current";_nextLabel="next";_currentPath="/current";_nextPath="/next";constructor(e,t,r=[]){this._current=e,this._next=t,this.collections=r}static make(e,t,r=[]){return new this(e,t,r)}set name(e){this._name=e}get name(){return this._name}set path(e){this._path=e}get path(){return this._path}set current(e){this._current=e}get current(){return this._current}set next(e){this._next=e}get next(){return this._next}set collections(e){e.forEach((e=>{e.archive=this})),this._collections=e}get collections(){return this.markCurrentAndNextCollections(this._collections)}set currentLabel(e){this._currentLabel=e}get currentLabel(){return this._currentLabel}set nextLabel(e){this._nextLabel=e}get nextLabel(){return this._nextLabel}set currentPath(e){this._currentPath=e}get currentPath(){return this._currentPath}get currentFullPath(){return f(this.path,this.currentPath)}set nextPath(e){this._nextPath=e}get nextPath(){return this._nextPath}get nextFullPath(){return f(this.path,this.nextPath)}asNavigationItem(){return{text:this.name,link:this.path,children:this.makeNavbarItemChildren()}}sidebarConfiguration(){let e={};return this.collections.forEach((t=>{e=Object.assign(e,t.asSidebarObject())})),e}makeNavbarItemChildren(){const e=[];return this.collections.forEach((t=>{e.push(t.asNavigationItem())})),e}markCurrentAndNextCollections(e){return e.forEach((e=>{e===this.next&&(e.name=this.nextLabel,e.path=this.nextPath),e===this.current&&(e.name=this.currentLabel,e.path=this.currentPath)})),e}}.make(L,C,A);const F=(0,h.Lk)("strong",null,"It has not yet been released!",-1),w=(0,h.Lk)("strong",null,"It is no longer supported!",-1);var j={enhance({app:e,router:t,siteData:r}){},setup(){},rootComponents:[],layouts:{Layout:(0,h.pM)({__name:"Layout",setup(e){const t=(0,b.BV)(),r=function(e,t){return(0,h.EW)((()=>x(e,t)))}(t,P),a=function(e,t,r=["/"]){return(0,h.EW)((()=>function(e,t,r=["/"]){const a=e.value.path;return!r.includes(a)&&a!==t.path+"/"&&!x(e,t)&&!function(e,t){const r=t.currentFullPath;return e.value.path.startsWith(r)}(e,t)}(e,t,r)))}(t,P);return(e,t)=>((0,h.uX)(),(0,h.Wv)(g.A,null,{"page-top":(0,h.k6)((()=>[(0,d.R1)(r)?((0,h.uX)(),(0,h.Wv)(v,{key:0},{default:(0,h.k6)((()=>[(0,h.eW)(" You are viewing documentation for an upcoming version. "),F,(0,h.eW)("! ")])),_:1})):(0,h.Q3)("",!0),(0,d.R1)(a)?((0,h.uX)(),(0,h.Wv)(v,{key:1,type:"danger",label:"Warning"},{default:(0,h.k6)((()=>[(0,h.eW)(" You are viewing documentation for an outdated version. "),w])),_:1})):(0,h.Q3)("",!0)])),_:1}))}})}};const I=[a.A,s.A,i.A,l.A,c.A,n.A,o.A,p.A,u.A,j]},3192:function(e,t,r){r.d(t,{J:function(){return s},c:function(){return a}});const a=JSON.parse("{}"),s=Object.fromEntries([["/",{loader:()=>r.e(4470).then(r.bind(r,5924)),meta:{title:""}}],["/archive/",{loader:()=>r.e(4470).then(r.bind(r,4546)),meta:{title:"Archive"}}],["/archive/not_available.html",{loader:()=>r.e(1711).then(r.bind(r,8193)),meta:{title:"Not Available"}}],["/archive/next/",{loader:()=>r.e(4470).then(r.bind(r,9635)),meta:{title:"Not Available"}}],["/archive/current/",{loader:()=>r.e(4470).then(r.bind(r,406)),meta:{title:"Release Notes"}}],["/archive/current/code-of-conduct.html",{loader:()=>r.e(2846).then(r.bind(r,3208)),meta:{title:"Code of Conduct"}}],["/archive/current/contribution-guide.html",{loader:()=>r.e(4975).then(r.bind(r,9476)),meta:{title:"Contribution Guide"}}],["/archive/current/origin.html",{loader:()=>r.e(3066).then(r.bind(r,6885)),meta:{title:"Origin"}}],["/archive/current/security.html",{loader:()=>r.e(9414).then(r.bind(r,4250)),meta:{title:"Security Policy"}}],["/archive/current/upgrade-guide.html",{loader:()=>r.e(5815).then(r.bind(r,8472)),meta:{title:"Upgrade Guide"}}],["/archive/current/packages/",{loader:()=>r.e(4470).then(r.bind(r,7957)),meta:{title:"Introduction"}}],["/archive/current/packages/contracts/",{loader:()=>r.e(4470).then(r.bind(r,8272)),meta:{title:"Introduction"}}],["/archive/current/packages/contracts/install.html",{loader:()=>r.e(469).then(r.bind(r,1640)),meta:{title:"How to install"}}],["/archive/current/packages/support/",{loader:()=>r.e(4470).then(r.bind(r,9046)),meta:{title:"Introduction"}}],["/archive/current/packages/support/install.html",{loader:()=>r.e(469).then(r.bind(r,492)),meta:{title:"How to install"}}],["/archive/current/packages/vuepress-utils/",{loader:()=>r.e(4470).then(r.bind(r,5706)),meta:{title:"Introduction"}}],["/archive/current/packages/vuepress-utils/install.html",{loader:()=>r.e(469).then(r.bind(r,5335)),meta:{title:"How to install"}}],["/archive/current/packages/xyz/",{loader:()=>r.e(4470).then(r.bind(r,1389)),meta:{title:"XYZ (test package)"}}],["/archive/current/packages/support/arrays/",{loader:()=>r.e(4470).then(r.bind(r,2019)),meta:{title:"About Arrays"}}],["/archive/current/packages/support/arrays/includesAll.html",{loader:()=>r.e(4610).then(r.bind(r,5567)),meta:{title:"Includes All"}}],["/archive/current/packages/support/arrays/includesAny.html",{loader:()=>r.e(5943).then(r.bind(r,1465)),meta:{title:"Includes Any"}}],["/archive/current/packages/support/arrays/isArrayLike.html",{loader:()=>r.e(7044).then(r.bind(r,844)),meta:{title:"Is Array Like"}}],["/archive/current/packages/support/arrays/isConcatSpreadable.html",{loader:()=>r.e(7627).then(r.bind(r,4801)),meta:{title:"Is Concat Spreadable"}}],["/archive/current/packages/support/arrays/isSafeArrayLike.html",{loader:()=>r.e(8071).then(r.bind(r,7240)),meta:{title:"Is Safe Array Like"}}],["/archive/current/packages/support/arrays/isTypedArray.html",{loader:()=>r.e(6805).then(r.bind(r,7187)),meta:{title:"Is Typed Array"}}],["/archive/current/packages/support/arrays/merge.html",{loader:()=>r.e(8802).then(r.bind(r,6060)),meta:{title:"Merge"}}],["/archive/current/packages/support/concerns/",{loader:()=>r.e(4470).then(r.bind(r,990)),meta:{title:"About Concerns"}}],["/archive/current/packages/support/concerns/aliases.html",{loader:()=>r.e(9994).then(r.bind(r,3981)),meta:{title:"Aliases"}}],["/archive/current/packages/support/concerns/booting.html",{loader:()=>r.e(86).then(r.bind(r,5008)),meta:{title:"Booting"}}],["/archive/current/packages/support/concerns/concernClass.html",{loader:()=>r.e(9628).then(r.bind(r,6482)),meta:{title:"Concern Class"}}],["/archive/current/packages/support/concerns/conflictResolution.html",{loader:()=>r.e(7428).then(r.bind(r,7321)),meta:{title:"Conflict Resolution"}}],["/archive/current/packages/support/concerns/edgeCases.html",{loader:()=>r.e(7920).then(r.bind(r,54)),meta:{title:"Edge Cases"}}],["/archive/current/packages/support/concerns/hooks.html",{loader:()=>r.e(2822).then(r.bind(r,6940)),meta:{title:"Hooks"}}],["/archive/current/packages/support/concerns/jsdoc.html",{loader:()=>r.e(6745).then(r.bind(r,7975)),meta:{title:"JSDoc"}}],["/archive/current/packages/support/concerns/prerequisites.html",{loader:()=>r.e(4261).then(r.bind(r,840)),meta:{title:"Prerequisites"}}],["/archive/current/packages/support/concerns/usage.html",{loader:()=>r.e(6333).then(r.bind(r,3623)),meta:{title:"Using Concerns"}}],["/archive/current/packages/support/exceptions/",{loader:()=>r.e(4470).then(r.bind(r,4535)),meta:{title:"About Exceptions"}}],["/archive/current/packages/support/exceptions/configureCustomError.html",{loader:()=>r.e(5807).then(r.bind(r,3866)),meta:{title:"Configure Custom Error"}}],["/archive/current/packages/support/exceptions/configureStackTrace.html",{loader:()=>r.e(3783).then(r.bind(r,2349)),meta:{title:"Configure Stack Trace"}}],["/archive/current/packages/support/exceptions/customErrors.html",{loader:()=>r.e(1816).then(r.bind(r,8394)),meta:{title:"Custom Errors"}}],["/archive/current/packages/support/exceptions/getErrorMessage.html",{loader:()=>r.e(9127).then(r.bind(r,5312)),meta:{title:"Get Error Message"}}],["/archive/current/packages/support/meta/",{loader:()=>r.e(4470).then(r.bind(r,332)),meta:{title:"About Meta"}}],["/archive/current/packages/support/meta/inheritance.html",{loader:()=>r.e(6406).then(r.bind(r,6501)),meta:{title:"Inheritance"}}],["/archive/current/packages/support/meta/outsideChanges.html",{loader:()=>r.e(5180).then(r.bind(r,1276)),meta:{title:"Outside Changes"}}],["/archive/current/packages/support/meta/prerequisites.html",{loader:()=>r.e(4261).then(r.bind(r,5265)),meta:{title:"Prerequisites"}}],["/archive/current/packages/support/meta/setAndGet.html",{loader:()=>r.e(3717).then(r.bind(r,3321)),meta:{title:"Set & Get"}}],["/archive/current/packages/support/meta/supported.html",{loader:()=>r.e(3248).then(r.bind(r,2302)),meta:{title:"Supported Elements"}}],["/archive/current/packages/support/meta/targetMeta.html",{loader:()=>r.e(676).then(r.bind(r,3037)),meta:{title:"Target Meta"}}],["/archive/current/packages/support/meta/tc39.html",{loader:()=>r.e(2021).then(r.bind(r,8338)),meta:{title:"TC39 Proposal"}}],["/archive/current/packages/support/misc/",{loader:()=>r.e(4470).then(r.bind(r,6892)),meta:{title:"About Misc."}}],["/archive/current/packages/support/misc/descTag.html",{loader:()=>r.e(9061).then(r.bind(r,9018)),meta:{title:"Desc. Tag"}}],["/archive/current/packages/support/misc/empty.html",{loader:()=>r.e(3295).then(r.bind(r,6616)),meta:{title:"Empty"}}],["/archive/current/packages/support/misc/isKey.html",{loader:()=>r.e(6529).then(r.bind(r,9845)),meta:{title:"Is Key"}}],["/archive/current/packages/support/misc/isPrimitive.html",{loader:()=>r.e(9383).then(r.bind(r,5615)),meta:{title:"Is Primitive"}}],["/archive/current/packages/support/misc/isPropertyKey.html",{loader:()=>r.e(5394).then(r.bind(r,9937)),meta:{title:"Is Property Key"}}],["/archive/current/packages/support/misc/isset.html",{loader:()=>r.e(9502).then(r.bind(r,8632)),meta:{title:"Isset"}}],["/archive/current/packages/support/misc/mergeKeys.html",{loader:()=>r.e(338).then(r.bind(r,903)),meta:{title:"Merge Keys"}}],["/archive/current/packages/support/misc/toWeakRef.html",{loader:()=>r.e(9912).then(r.bind(r,9904)),meta:{title:"To Weak Ref."}}],["/archive/current/packages/support/mixins/",{loader:()=>r.e(4470).then(r.bind(r,1205)),meta:{title:"About Mixins"}}],["/archive/current/packages/support/mixins/apply.html",{loader:()=>r.e(6262).then(r.bind(r,5126)),meta:{title:"Apply Mixins"}}],["/archive/current/packages/support/mixins/inheritance.html",{loader:()=>r.e(6406).then(r.bind(r,4661)),meta:{title:"Inheritance"}}],["/archive/current/packages/support/mixins/instanceof.html",{loader:()=>r.e(5646).then(r.bind(r,6192)),meta:{title:"Instanceof"}}],["/archive/current/packages/support/mixins/newMixin.html",{loader:()=>r.e(9495).then(r.bind(r,6251)),meta:{title:"New Mixin"}}],["/archive/current/packages/support/mixins/onward.html",{loader:()=>r.e(8411).then(r.bind(r,2231)),meta:{title:"Onward"}}],["/archive/current/packages/support/objects/",{loader:()=>r.e(4470).then(r.bind(r,3122)),meta:{title:"About Objects"}}],["/archive/current/packages/support/objects/forget.html",{loader:()=>r.e(4993).then(r.bind(r,8407)),meta:{title:"Forget"}}],["/archive/current/packages/support/objects/forgetAll.html",{loader:()=>r.e(7922).then(r.bind(r,8668)),meta:{title:"Forget All"}}],["/archive/current/packages/support/objects/get.html",{loader:()=>r.e(754).then(r.bind(r,9657)),meta:{title:"Get"}}],["/archive/current/packages/support/objects/has.html",{loader:()=>r.e(3246).then(r.bind(r,9586)),meta:{title:"Has"}}],["/archive/current/packages/support/objects/hasAll.html",{loader:()=>r.e(8423).then(r.bind(r,1747)),meta:{title:"Has All"}}],["/archive/current/packages/support/objects/hasAny.html",{loader:()=>r.e(9150).then(r.bind(r,4079)),meta:{title:"Has Any"}}],["/archive/current/packages/support/objects/hasUniqueId.html",{loader:()=>r.e(8852).then(r.bind(r,1862)),meta:{title:"Has Unique ID"}}],["/archive/current/packages/support/objects/isCloneable.html",{loader:()=>r.e(6247).then(r.bind(r,2572)),meta:{title:"Is Cloneable"}}],["/archive/current/packages/support/objects/isPopulatable.html",{loader:()=>r.e(6321).then(r.bind(r,6565)),meta:{title:"Is Populatable"}}],["/archive/current/packages/support/objects/isset.html",{loader:()=>r.e(9502).then(r.bind(r,906)),meta:{title:"Isset"}}],["/archive/current/packages/support/objects/merge.html",{loader:()=>r.e(8802).then(r.bind(r,820)),meta:{title:"Merge"}}],["/archive/current/packages/support/objects/populate.html",{loader:()=>r.e(7902).then(r.bind(r,5766)),meta:{title:"Populate"}}],["/archive/current/packages/support/objects/set.html",{loader:()=>r.e(3518).then(r.bind(r,9819)),meta:{title:"Set"}}],["/archive/current/packages/support/objects/uniqueId.html",{loader:()=>r.e(6054).then(r.bind(r,7717)),meta:{title:"Unique ID"}}],["/archive/current/packages/support/reflections/",{loader:()=>r.e(4470).then(r.bind(r,1783)),meta:{title:"About reflections"}}],["/archive/current/packages/support/reflections/assertHasPrototypeProperty.html",{loader:()=>r.e(8925).then(r.bind(r,3644)),meta:{title:"Assert Has Prototype Prop."}}],["/archive/current/packages/support/reflections/classLooksLike.html",{loader:()=>r.e(2023).then(r.bind(r,1274)),meta:{title:"Class Looks Like"}}],["/archive/current/packages/support/reflections/classOwnKeys.html",{loader:()=>r.e(984).then(r.bind(r,5491)),meta:{title:"Class Own Keys"}}],["/archive/current/packages/support/reflections/getAllParentsOfClass.html",{loader:()=>r.e(3503).then(r.bind(r,7210)),meta:{title:"Get All Parents Of Class"}}],["/archive/current/packages/support/reflections/getClassPropertyDescriptor.html",{loader:()=>r.e(572).then(r.bind(r,463)),meta:{title:"Get Class Prop. Descriptor"}}],["/archive/current/packages/support/reflections/getClassPropertyDescriptors.html",{loader:()=>r.e(9443).then(r.bind(r,9595)),meta:{title:"Get Class Prop. Descriptors"}}],["/archive/current/packages/support/reflections/getConstructorName.html",{loader:()=>r.e(9583).then(r.bind(r,3252)),meta:{title:"Get Constructor Name"}}],["/archive/current/packages/support/reflections/getNameOrDesc.html",{loader:()=>r.e(1705).then(r.bind(r,2075)),meta:{title:"Get Name Or Desc. Tag"}}],["/archive/current/packages/support/reflections/getParentOfClass.html",{loader:()=>r.e(5067).then(r.bind(r,7836)),meta:{title:"Get Parent Of Class"}}],["/archive/current/packages/support/reflections/hasAllMethods.html",{loader:()=>r.e(1901).then(r.bind(r,3184)),meta:{title:"Has All Methods"}}],["/archive/current/packages/support/reflections/hasMethod.html",{loader:()=>r.e(8483).then(r.bind(r,8869)),meta:{title:"Has Method"}}],["/archive/current/packages/support/reflections/hasPrototypeProperty.html",{loader:()=>r.e(3287).then(r.bind(r,6195)),meta:{title:"Has Prototype Property"}}],["/archive/current/packages/support/reflections/isConstructor.html",{loader:()=>r.e(8874).then(r.bind(r,5843)),meta:{title:"Is Constructor"}}],["/archive/current/packages/support/reflections/isKeySafe.html",{loader:()=>r.e(9088).then(r.bind(r,6536)),meta:{title:"Is Key Safe"}}],["/archive/current/packages/support/reflections/isKeyUnsafe.html",{loader:()=>r.e(4795).then(r.bind(r,715)),meta:{title:"Is Key Unsafe"}}],["/archive/current/packages/support/reflections/isSubclass.html",{loader:()=>r.e(3082).then(r.bind(r,2408)),meta:{title:"Is Subclass"}}],["/archive/current/packages/support/reflections/isSubclassOrLooksLike.html",{loader:()=>r.e(4648).then(r.bind(r,5092)),meta:{title:"Is Subclass Or Looks Like"}}],["/archive/current/packages/support/reflections/isWeakKind.html",{loader:()=>r.e(9058).then(r.bind(r,6820)),meta:{title:"Is WeakKind"}}],["/archive/current/packages/vuepress-utils/components/version-disclaimer.html",{loader:()=>r.e(6368).then(r.bind(r,6679)),meta:{title:"Version Disclaimer"}}],["/archive/current/packages/vuepress-utils/navigation/archive.html",{loader:()=>r.e(3100).then(r.bind(r,4655)),meta:{title:"Archive"}}],["/archive/current/packages/vuepress-utils/plugins/last-updated.html",{loader:()=>r.e(8518).then(r.bind(r,4306)),meta:{title:"Last Updated"}}],["/404.html",{loader:()=>r.e(7490).then(r.bind(r,2632)),meta:{title:""}}]])},8752:function(e,t,r){r.d(t,{b:function(){return a}});const a=[{title:"Release Notes",headers:[{level:2,title:"Support Policy",slug:"support-policy",link:"#support-policy",children:[]},{level:2,title:"v0.x Highlights",slug:"v0-x-highlights",link:"#v0-x-highlights",children:[{level:3,title:"Concerns",slug:"concerns",link:"#concerns",children:[]},{level:3,title:"Merge",slug:"merge",link:"#merge",children:[]},{level:3,title:"Mixins",slug:"mixins",link:"#mixins",children:[]},{level:3,title:'"Target" Meta Decorator',slug:"target-meta-decorator",link:"#target-meta-decorator",children:[]},{level:3,title:"Meta Decorator",slug:"meta-decorator",link:"#meta-decorator",children:[]},{level:3,title:"Support",slug:"support",link:"#support",children:[]},{level:3,title:"Vuepress Utils",slug:"vuepress-utils",link:"#vuepress-utils",children:[]}]}],path:"/archive/current/",pathLocale:"/",extraFields:["Ion Release Notes"]},{title:"Code of Conduct",headers:[{level:2,title:"Consequences",slug:"consequences",link:"#consequences",children:[]}],path:"/archive/current/code-of-conduct.html",pathLocale:"/",extraFields:["Code of Conduct - Ion"]},{title:"Contribution Guide",headers:[{level:2,title:"Bug Report",slug:"bug-report",link:"#bug-report",children:[]},{level:2,title:"Security Vulnerability",slug:"security-vulnerability",link:"#security-vulnerability",children:[]},{level:2,title:"Feature Request",slug:"feature-request",link:"#feature-request",children:[]},{level:2,title:"Fork, code and send pull-request",slug:"fork-code-and-send-pull-request",link:"#fork-code-and-send-pull-request",children:[]}],path:"/archive/current/contribution-guide.html",pathLocale:"/",extraFields:["How to contribute to Ion"]},{title:"Origin",headers:[{level:2,title:'Meaning of "Ion"',slug:"meaning-of-ion",link:"#meaning-of-ion",children:[]}],path:"/archive/current/origin.html",pathLocale:"/",extraFields:["The origin of Ion"]},{title:"Security Policy",headers:[{level:2,title:"How to report a vulnerability",slug:"how-to-report-a-vulnerability",link:"#how-to-report-a-vulnerability",children:[{level:3,title:"Public PGP Key",slug:"public-pgp-key",link:"#public-pgp-key",children:[]}]},{level:2,title:"Supported Versions",slug:"supported-versions",link:"#supported-versions",children:[]}],path:"/archive/current/security.html",pathLocale:"/",extraFields:["Security Policy of Athenaeum"]},{title:"Upgrade Guide",headers:[{level:2,title:"From v0.7.x- to v0.10.x",slug:"from-v0-7-x-to-v0-10-x",link:"#from-v0-7-x-to-v0-10-x",children:[{level:3,title:"Meta (types)",slug:"meta-types",link:"#meta-types",children:[]},{level:3,title:"Meta (targetMeta() and inheritTargetMeta())",slug:"meta-targetmeta-and-inherittargetmeta",link:"#meta-targetmeta-and-inherittargetmeta",children:[]}]},{level:2,title:"From v0.6.x to v0.7.x",slug:"from-v0-6-x-to-v0-7-x",link:"#from-v0-6-x-to-v0-7-x",children:[{level:3,title:"Node.js 20.11.0 Required",slug:"node-js-20-11-0-required",link:"#node-js-20-11-0-required",children:[]},{level:3,title:"Meta",slug:"meta",link:"#meta",children:[]},{level:3,title:"Vuepress Utils",slug:"vuepress-utils",link:"#vuepress-utils",children:[]}]},{level:2,title:"From v0.3.x to v0.4.x",slug:"from-v0-3-x-to-v0-4-x",link:"#from-v0-3-x-to-v0-4-x",children:[{level:3,title:"Rest Parameters for forgetAll(), hasAll() and hasAny()",slug:"rest-parameters-for-forgetall-hasall-and-hasany",link:"#rest-parameters-for-forgetall-hasall-and-hasany",children:[]}]},{level:2,title:"Onward",slug:"onward",link:"#onward",children:[]}],path:"/archive/current/upgrade-guide.html",pathLocale:"/",extraFields:["Ion Upgrade Guide"]},{title:"Introduction",headers:[{level:2,title:"Environment",slug:"environment",link:"#environment",children:[]},{level:2,title:"Available Since",slug:"available-since",link:"#available-since",children:[]},{level:2,title:"Not Released",slug:"not-released",link:"#not-released",children:[]},{level:2,title:"Not Published",slug:"not-published",link:"#not-published",children:[]}],path:"/archive/current/packages/",pathLocale:"/",extraFields:["Ion Packages"]},{title:"Introduction",headers:[],path:"/archive/current/packages/contracts/",pathLocale:"/",extraFields:["Ion Support package"]},{title:"How to install",headers:[{level:2,title:"npm",slug:"npm",link:"#npm",children:[]},{level:2,title:"yarn",slug:"yarn",link:"#yarn",children:[]},{level:2,title:"pnpm",slug:"pnpm",link:"#pnpm",children:[]}],path:"/archive/current/packages/contracts/install.html",pathLocale:"/",extraFields:["How to install Ion Contracts package"]},{title:"Introduction",headers:[],path:"/archive/current/packages/support/",pathLocale:"/",extraFields:["Ion Support package"]},{title:"How to install",headers:[{level:2,title:"npm",slug:"npm",link:"#npm",children:[]},{level:2,title:"yarn",slug:"yarn",link:"#yarn",children:[]},{level:2,title:"pnpm",slug:"pnpm",link:"#pnpm",children:[]}],path:"/archive/current/packages/support/install.html",pathLocale:"/",extraFields:["How to install Ion Support package"]},{title:"Introduction",headers:[{level:2,title:"Navigation",slug:"navigation",link:"#navigation",children:[]},{level:2,title:"Plugins",slug:"plugins",link:"#plugins",children:[]},{level:2,title:"Components",slug:"components",link:"#components",children:[]}],path:"/archive/current/packages/vuepress-utils/",pathLocale:"/",extraFields:["Various helpers for your vuepress site"]},{title:"How to install",headers:[{level:2,title:"npm",slug:"npm",link:"#npm",children:[]},{level:2,title:"yarn",slug:"yarn",link:"#yarn",children:[]},{level:2,title:"pnpm",slug:"pnpm",link:"#pnpm",children:[]}],path:"/archive/current/packages/vuepress-utils/install.html",pathLocale:"/",extraFields:["How to install Vuepress Utils"]},{title:"XYZ (test package)",headers:[],path:"/archive/current/packages/xyz/",pathLocale:"/",extraFields:["XYZ Test Package"]},{title:"About Arrays",headers:[],path:"/archive/current/packages/support/arrays/",pathLocale:"/",extraFields:["Array utilities."]},{title:"Includes All",headers:[],path:"/archive/current/packages/support/arrays/includesAll.html",pathLocale:"/",extraFields:["Determine if array contains all values."]},{title:"Includes Any",headers:[],path:"/archive/current/packages/support/arrays/includesAny.html",pathLocale:"/",extraFields:["Determine if array contains some values."]},{title:"Is Array Like",headers:[],path:"/archive/current/packages/support/arrays/isArrayLike.html",pathLocale:"/",extraFields:["Determine if value is array-like."]},{title:"Is Concat Spreadable",headers:[],path:"/archive/current/packages/support/arrays/isConcatSpreadable.html",pathLocale:"/",extraFields:["Determine if object is concat spreadable."]},{title:"Is Safe Array Like",headers:[],path:"/archive/current/packages/support/arrays/isSafeArrayLike.html",pathLocale:"/",extraFields:['Determine if value is "safe" array-like.']},{title:"Is Typed Array",headers:[],path:"/archive/current/packages/support/arrays/isTypedArray.html",pathLocale:"/",extraFields:["Determine if object is a typed array."]},{title:"Merge",headers:[{level:2,title:"Deep Copy Objects",slug:"deep-copy-objects",link:"#deep-copy-objects",children:[]},{level:2,title:"When unable to merge values",slug:"when-unable-to-merge-values",link:"#when-unable-to-merge-values",children:[]}],path:"/archive/current/packages/support/arrays/merge.html",pathLocale:"/",extraFields:["Merge multiple arrays into a new array."]},{title:"About Concerns",headers:[{level:2,title:"Example",slug:"example",link:"#example",children:[]}],path:"/archive/current/packages/support/concerns/",pathLocale:"/",extraFields:["Alternative mixin utility."]},{title:"Aliases",headers:[{level:2,title:"Properties & Methods",slug:"properties-methods",link:"#properties-methods",children:[]},{level:2,title:"If property or method already exists",slug:"if-property-or-method-already-exists",link:"#if-property-or-method-already-exists",children:[]}],path:"/archive/current/packages/support/concerns/aliases.html",pathLocale:"/",extraFields:["What are aliases"]},{title:"Booting",headers:[{level:2,title:"Manual Booting",slug:"manual-booting",link:"#manual-booting",children:[{level:3,title:"Boot All Concerns",slug:"boot-all-concerns",link:"#boot-all-concerns",children:[]}]}],path:"/archive/current/packages/support/concerns/booting.html",pathLocale:"/",extraFields:["How concerns are booted"]},{title:"Concern Class",headers:[{level:2,title:"Inherit from AbstractConcern",slug:"inherit-from-abstractconcern",link:"#inherit-from-abstractconcern",children:[{level:3,title:"Private Members",slug:"private-members",link:"#private-members",children:[]},{level:3,title:"Static Members",slug:"static-members",link:"#static-members",children:[]},{level:3,title:"Transpilers",slug:"transpilers",link:"#transpilers",children:[]}]},{level:2,title:'Customise "alias" members',slug:"customise-alias-members",link:"#customise-alias-members",children:[]},{level:2,title:"Concern Owner instance",slug:"concern-owner-instance",link:"#concern-owner-instance",children:[]},{level:2,title:"Constructor",slug:"constructor",link:"#constructor",children:[]}],path:"/archive/current/packages/support/concerns/concernClass.html",pathLocale:"/",extraFields:["How to define a new concern class."]},{title:"Conflict Resolution",headers:[{level:2,title:"Naming Conflicts",slug:"naming-conflicts",link:"#naming-conflicts",children:[]},{level:2,title:"Resolve Naming Conflicts",slug:"resolve-naming-conflicts",link:"#resolve-naming-conflicts",children:[]},{level:2,title:"Prevent Aliases",slug:"prevent-aliases",link:"#prevent-aliases",children:[]},{level:2,title:"Shorthand Configuration",slug:"shorthand-configuration",link:"#shorthand-configuration",children:[]}],path:"/archive/current/packages/support/concerns/conflictResolution.html",pathLocale:"/",extraFields:["How to deal with naming conflicts"]},{title:"Edge Cases",headers:[{level:2,title:"Getter & Setter declared in different concerns",slug:"getter-setter-declared-in-different-concerns",link:"#getter-setter-declared-in-different-concerns",children:[]},{level:2,title:"Inheritance vs. Concern members",slug:"inheritance-vs-concern-members",link:"#inheritance-vs-concern-members",children:[]},{level:2,title:"Concerns using other concerns",slug:"concerns-using-other-concerns",link:"#concerns-using-other-concerns",children:[]}],path:"/archive/current/packages/support/concerns/edgeCases.html",pathLocale:"/",extraFields:["A few edge cases when making or using concerns"]},{title:"Hooks",headers:[{level:2,title:"BEFORE Registration",slug:"before-registration",link:"#before-registration",children:[]},{level:2,title:"AFTER Registration",slug:"after-registration",link:"#after-registration",children:[]}],path:"/archive/current/packages/support/concerns/hooks.html",pathLocale:"/",extraFields:["How to use registration hooks"]},{title:"JSDoc",headers:[{level:2,title:"@mixin and @mixes",slug:"mixin-and-mixes",link:"#mixin-and-mixes",children:[]},{level:2,title:"@property",slug:"property",link:"#property",children:[]},{level:2,title:"@borrows",slug:"borrows",link:"#borrows",children:[]},{level:2,title:"@member",slug:"member",link:"#member",children:[]}],path:"/archive/current/packages/support/concerns/jsdoc.html",pathLocale:"/",extraFields:["A wat to document what concerns a targer class uses."]},{title:"Prerequisites",headers:[],path:"/archive/current/packages/support/concerns/prerequisites.html",pathLocale:"/",extraFields:["Prerequisites for using concerns."]},{title:"Using Concerns",headers:[{level:2,title:"Using Concerns",slug:"using-concerns",link:"#using-concerns",children:[]},{level:2,title:"Inheritance",slug:"inheritance",link:"#inheritance",children:[]},{level:2,title:"Manual interaction",slug:"manual-interaction",link:"#manual-interaction",children:[{level:3,title:"Determine if target uses concerns",slug:"determine-if-target-uses-concerns",link:"#determine-if-target-uses-concerns",children:[]}]}],path:"/archive/current/packages/support/concerns/usage.html",pathLocale:"/",extraFields:["How to use concerns."]},{title:"About Exceptions",headers:[],path:"/archive/current/packages/support/exceptions/",pathLocale:"/",extraFields:["Error & Exceptions utilities."]},{title:"Configure Custom Error",headers:[{level:2,title:"Arguments",slug:"arguments",link:"#arguments",children:[]}],path:"/archive/current/packages/support/exceptions/configureCustomError.html",pathLocale:"/",extraFields:["Configuration of custom errors."]},{title:"Configure Stack Trace",headers:[{level:2,title:"Arguments",slug:"arguments",link:"#arguments",children:[]}],path:"/archive/current/packages/support/exceptions/configureStackTrace.html",pathLocale:"/",extraFields:["Configuration error stack trace."]},{title:"Custom Errors",headers:[{level:2,title:"AbstractClassError",slug:"abstractclasserror",link:"#abstractclasserror",children:[]},{level:2,title:"LogicalError",slug:"logicalerror",link:"#logicalerror",children:[]}],path:"/archive/current/packages/support/exceptions/customErrors.html",pathLocale:"/",extraFields:["Predefined custom errors."]},{title:"Get Error Message",headers:[],path:"/archive/current/packages/support/exceptions/getErrorMessage.html",pathLocale:"/",extraFields:["Obtain error or default message."]},{title:"About Meta",headers:[],path:"/archive/current/packages/support/meta/",pathLocale:"/",extraFields:["Add arbitrary metadata on classes, methods and properties."]},{title:"Inheritance",headers:[{level:2,title:"Overwrites",slug:"overwrites",link:"#overwrites",children:[]}],path:"/archive/current/packages/support/meta/inheritance.html",pathLocale:"/",extraFields:["About metadata inheritance and overwrites."]},{title:"Outside Changes",headers:[],path:"/archive/current/packages/support/meta/outsideChanges.html",pathLocale:"/",extraFields:["About changes to metadata outside decorator scope."]},{title:"Prerequisites",headers:[],path:"/archive/current/packages/support/meta/prerequisites.html",pathLocale:"/",extraFields:["Prerequisites for using meta decorators."]},{title:"Set & Get",headers:[{level:2,title:"Set Metadata",slug:"set-metadata",link:"#set-metadata",children:[]},{level:2,title:"Get Metadata",slug:"get-metadata",link:"#get-metadata",children:[{level:3,title:"Default Value",slug:"default-value",link:"#default-value",children:[]}]},{level:2,title:"Callback",slug:"callback",link:"#callback",children:[]}],path:"/archive/current/packages/support/meta/setAndGet.html",pathLocale:"/",extraFields:["Defining and retrieving metadata."]},{title:"Supported Elements",headers:[],path:"/archive/current/packages/support/meta/supported.html",pathLocale:"/",extraFields:["Supported elements by meta decorators."]},{title:"Target Meta",headers:[{level:2,title:"Supported Elements",slug:"supported-elements",link:"#supported-elements",children:[]},{level:2,title:"Class Instance",slug:"class-instance",link:"#class-instance",children:[]},{level:2,title:"Method Reference",slug:"method-reference",link:"#method-reference",children:[]},{level:2,title:"Inheritance",slug:"inheritance",link:"#inheritance",children:[{level:3,title:"Static Methods",slug:"static-methods",link:"#static-methods",children:[]}]}],path:"/archive/current/packages/support/meta/targetMeta.html",pathLocale:"/",extraFields:["Associate metadata with a class instance or class method reference."]},{title:"TC39 Proposal",headers:[],path:"/archive/current/packages/support/meta/tc39.html",pathLocale:"/",extraFields:["In relation to TC39 Decorator Metadata proposal"]},{title:"About Misc.",headers:[],path:"/archive/current/packages/support/misc/",pathLocale:"/",extraFields:["Miscellaneous utility functions."]},{title:"Desc. Tag",headers:[],path:"/archive/current/packages/support/misc/descTag.html",pathLocale:"/",extraFields:["Object description tag"]},{title:"Empty",headers:[{level:2,title:"WeakMap and WeakSet",slug:"weakmap-and-weakset",link:"#weakmap-and-weakset",children:[]}],path:"/archive/current/packages/support/misc/empty.html",pathLocale:"/",extraFields:["Determine if value is empty"]},{title:"Is Key",headers:[],path:"/archive/current/packages/support/misc/isKey.html",pathLocale:"/",extraFields:["Determine if is a key or path identifier"]},{title:"Is Primitive",headers:[],path:"/archive/current/packages/support/misc/isPrimitive.html",pathLocale:"/",extraFields:["Determine if value is a primitive."]},{title:"Is Property Key",headers:[],path:"/archive/current/packages/support/misc/isPropertyKey.html",pathLocale:"/",extraFields:["Determine if key is a valid property key name."]},{title:"Isset",headers:[{level:2,title:"Multiple values",slug:"multiple-values",link:"#multiple-values",children:[]}],path:"/archive/current/packages/support/misc/isset.html",pathLocale:"/",extraFields:["Determine if value isset."]},{title:"Merge Keys",headers:[],path:"/archive/current/packages/support/misc/mergeKeys.html",pathLocale:"/",extraFields:["Merge keys into a single key."]},{title:"To Weak Ref.",headers:[],path:"/archive/current/packages/support/misc/toWeakRef.html",pathLocale:"/",extraFields:["Wrap object into a Weak Reference."]},{title:"About Mixins",headers:[],path:"/archive/current/packages/support/mixins/",pathLocale:"/",extraFields:['Abstract subclasses ("Mixins") utilities']},{title:"Apply Mixins",headers:[{level:2,title:"Extending Superclass",slug:"extending-superclass",link:"#extending-superclass",children:[]}],path:"/archive/current/packages/support/mixins/apply.html",pathLocale:"/",extraFields:["How to apply mixins."]},{title:"Inheritance",headers:[],path:"/archive/current/packages/support/mixins/inheritance.html",pathLocale:"/",extraFields:["How inheritance works."]},{title:"Instanceof",headers:[],path:"/archive/current/packages/support/mixins/instanceof.html",pathLocale:"/",extraFields:["Using instanceof operator."]},{title:"New Mixin",headers:[{level:2,title:"Constructor",slug:"constructor",link:"#constructor",children:[]}],path:"/archive/current/packages/support/mixins/newMixin.html",pathLocale:"/",extraFields:["How to defined a new Mixin class."]},{title:"Onward",headers:[],path:"/archive/current/packages/support/mixins/onward.html",pathLocale:"/",extraFields:["Where to read more about mixins."]},{title:"About Objects",headers:[],path:"/archive/current/packages/support/objects/",pathLocale:"/",extraFields:["Objects related utilities"]},{title:"Forget",headers:[],path:"/archive/current/packages/support/objects/forget.html",pathLocale:"/",extraFields:["Forget object key"]},{title:"Forget All",headers:[],path:"/archive/current/packages/support/objects/forgetAll.html",pathLocale:"/",extraFields:["Forget object all keys"]},{title:"Get",headers:[{level:2,title:"Default Value",slug:"default-value",link:"#default-value",children:[]}],path:"/archive/current/packages/support/objects/get.html",pathLocale:"/",extraFields:["Get object value from given path."]},{title:"Has",headers:[],path:"/archive/current/packages/support/objects/has.html",pathLocale:"/",extraFields:["Determine if object path is a property."]},{title:"Has All",headers:[],path:"/archive/current/packages/support/objects/hasAll.html",pathLocale:"/",extraFields:["Determine if all object paths are properties."]},{title:"Has Any",headers:[],path:"/archive/current/packages/support/objects/hasAny.html",pathLocale:"/",extraFields:["Determine if any object paths are properties."]},{title:"Has Unique ID",headers:[],path:"/archive/current/packages/support/objects/hasUniqueId.html",pathLocale:"/",extraFields:["Determine if object has a unique id."]},{title:"Is Cloneable",headers:[],path:"/archive/current/packages/support/objects/isCloneable.html",pathLocale:"/",extraFields:["Determine if object is cloneable."]},{title:"Is Populatable",headers:[],path:"/archive/current/packages/support/objects/isPopulatable.html",pathLocale:"/",extraFields:["Determine if object is populatable."]},{title:"Isset",headers:[],path:"/archive/current/packages/support/objects/isset.html",pathLocale:"/",extraFields:["Determine if object object paths are set and have values."]},{title:"Merge",headers:[{level:2,title:"Shallow Copied Types",slug:"shallow-copied-types",link:"#shallow-copied-types",children:[]},{level:2,title:"Unsafe Keys",slug:"unsafe-keys",link:"#unsafe-keys",children:[]},{level:2,title:"Merge Options",slug:"merge-options",link:"#merge-options",children:[{level:3,title:"depth",slug:"depth",link:"#depth",children:[]},{level:3,title:"skip",slug:"skip",link:"#skip",children:[]},{level:3,title:"overwriteWithUndefined",slug:"overwritewithundefined",link:"#overwritewithundefined",children:[]},{level:3,title:"useCloneable",slug:"usecloneable",link:"#usecloneable",children:[]},{level:3,title:"mergeArrays",slug:"mergearrays",link:"#mergearrays",children:[]},{level:3,title:"callback",slug:"callback",link:"#callback",children:[]}]}],path:"/archive/current/packages/support/objects/merge.html",pathLocale:"/",extraFields:["Merge multiple objects into a new object."]},{title:"Populate",headers:[{level:2,title:"Arguments",slug:"arguments",link:"#arguments",children:[]},{level:2,title:"Limit keys to populate",slug:"limit-keys-to-populate",link:"#limit-keys-to-populate",children:[]},{level:2,title:"Source Keys Callback",slug:"source-keys-callback",link:"#source-keys-callback",children:[]},{level:2,title:"When keys do not exist",slug:"when-keys-do-not-exist",link:"#when-keys-do-not-exist",children:[]}],path:"/archive/current/packages/support/objects/populate.html",pathLocale:"/",extraFields:["Populate target object."]},{title:"Set",headers:[],path:"/archive/current/packages/support/objects/set.html",pathLocale:"/",extraFields:["Set value in object path."]},{title:"Unique ID",headers:[],path:"/archive/current/packages/support/objects/uniqueId.html",pathLocale:"/",extraFields:["Set value in object path."]},{title:"About reflections",headers:[],path:"/archive/current/packages/support/reflections/",pathLocale:"/",extraFields:["Reflection utilities."]},{title:"Assert Has Prototype Prop.",headers:[],path:"/archive/current/packages/support/reflections/assertHasPrototypeProperty.html",pathLocale:"/",extraFields:['Assert that object has a "prototype" property.']},{title:"Class Looks Like",headers:[{level:2,title:"Arguments",slug:"arguments",link:"#arguments",children:[]},{level:2,title:"Class Blueprint",slug:"class-blueprint",link:"#class-blueprint",children:[]},{level:2,title:"Recursive",slug:"recursive",link:"#recursive",children:[]}],path:"/archive/current/packages/support/reflections/classLooksLike.html",pathLocale:"/",extraFields:["Determine if a class looks like blueprint."]},{title:"Class Own Keys",headers:[{level:2,title:"Limitation",slug:"limitation",link:"#limitation",children:[]}],path:"/archive/current/packages/support/reflections/classOwnKeys.html",pathLocale:"/",extraFields:["Get property keys of target class."]},{title:"Get All Parents Of Class",headers:[],path:"/archive/current/packages/support/reflections/getAllParentsOfClass.html",pathLocale:"/",extraFields:["Get all parents of a class"]},{title:"Get Class Prop. Descriptor",headers:[],path:"/archive/current/packages/support/reflections/getClassPropertyDescriptor.html",pathLocale:"/",extraFields:["Get property descriptor of target class property."]},{title:"Get Class Prop. Descriptors",headers:[],path:"/archive/current/packages/support/reflections/getClassPropertyDescriptors.html",pathLocale:"/",extraFields:["Get all property descriptors of target class."]},{title:"Get Constructor Name",headers:[],path:"/archive/current/packages/support/reflections/getConstructorName.html",pathLocale:"/",extraFields:["Get name of target class' constructor"]},{title:"Get Name Or Desc. Tag",headers:[],path:"/archive/current/packages/support/reflections/getNameOrDesc.html",pathLocale:"/",extraFields:["Get name of target class' constructor, or description tag"]},{title:"Get Parent Of Class",headers:[],path:"/archive/current/packages/support/reflections/getParentOfClass.html",pathLocale:"/",extraFields:["Get parent class."]},{title:"Has All Methods",headers:[],path:"/archive/current/packages/support/reflections/hasAllMethods.html",pathLocale:"/",extraFields:["Determine if target has all methods"]},{title:"Has Method",headers:[],path:"/archive/current/packages/support/reflections/hasMethod.html",pathLocale:"/",extraFields:["Determine if target has method"]},{title:"Has Prototype Property",headers:[],path:"/archive/current/packages/support/reflections/hasPrototypeProperty.html",pathLocale:"/",extraFields:['Determine if "prototype" property exists.']},{title:"Is Constructor",headers:[],path:"/archive/current/packages/support/reflections/isConstructor.html",pathLocale:"/",extraFields:["Determine if value is a constructor."]},{title:"Is Key Safe",headers:[{level:2,title:"isKeySafe",slug:"iskeysafe",link:"#iskeysafe",children:[]}],path:"/archive/current/packages/support/reflections/isKeySafe.html",pathLocale:"/",extraFields:["Determine if a property key is safe."]},{title:"Is Key Unsafe",headers:[],path:"/archive/current/packages/support/reflections/isKeyUnsafe.html",pathLocale:"/",extraFields:["Determine if a property key is unsafe."]},{title:"Is Subclass",headers:[],path:"/archive/current/packages/support/reflections/isSubclass.html",pathLocale:"/",extraFields:["Determine if target is a subclass of another class."]},{title:"Is Subclass Or Looks Like",headers:[],path:"/archive/current/packages/support/reflections/isSubclassOrLooksLike.html",pathLocale:"/",extraFields:["Determine if target is a subclass of another class, or looks like blueprint"]},{title:"Is WeakKind",headers:[],path:"/archive/current/packages/support/reflections/isWeakKind.html",pathLocale:"/",extraFields:['Determine if object is of a "weak" kind.']},{title:"Version Disclaimer",headers:[{level:2,title:"Properties",slug:"properties",link:"#properties",children:[{level:3,title:"type (optional)",slug:"type-optional",link:"#type-optional",children:[]},{level:3,title:"label (optional)",slug:"label-optional",link:"#label-optional",children:[]}]},{level:2,title:"Extend Default Layout",slug:"extend-default-layout",link:"#extend-default-layout",children:[]},{level:2,title:"Client Config",slug:"client-config",link:"#client-config",children:[]}],path:"/archive/current/packages/vuepress-utils/components/version-disclaimer.html",pathLocale:"/",extraFields:["A simple notice container"]},{title:"Archive",headers:[{level:2,title:"Directory Structure",slug:"directory-structure",link:"#directory-structure",children:[]},{level:2,title:"Collections",slug:"collections",link:"#collections",children:[]},{level:2,title:"Archive Instance",slug:"archive-instance",link:"#archive-instance",children:[{level:3,title:"Name & Path",slug:"name-path",link:"#name-path",children:[]},{level:3,title:"Current & Next",slug:"current-next",link:"#current-next",children:[]}]},{level:2,title:"Vuepress Config File",slug:"vuepress-config-file",link:"#vuepress-config-file",children:[]},{level:2,title:"Onward",slug:"onward",link:"#onward",children:[]}],path:"/archive/current/packages/vuepress-utils/navigation/archive.html",pathLocale:"/",extraFields:["Archive Structure and Navigation"]},{title:"Last Updated",headers:[{level:2,title:"How to use",slug:"how-to-use",link:"#how-to-use",children:[]},{level:2,title:"Format",slug:"format",link:"#format",children:[]}],path:"/archive/current/packages/vuepress-utils/plugins/last-updated.html",pathLocale:"/",extraFields:["Last Updated Date Vuepress plugins"]}]},1901:function(e,t,r){r.d(t,{U:function(){return a}});const a=JSON.parse('{"base":"/ion/","lang":"en-GB","title":"Ion","description":"Ion Official Documentation","head":[["link",{"rel":"apple-touch-icon","sizes":"180x180","href":"/ion/images/icon/apple-touch-icon.png"}],["link",{"rel":"icon","type":"image/png","sizes":"32x32","href":"/ion/images/icon/favicon-32x32.png"}],["link",{"rel":"icon","type":"image/png","sizes":"16x16","href":"/ion/images/icon/favicon-16x16.png"}],["link",{"rel":"manifest","href":"/ion/site.webmanifest"}]],"locales":{}}')},7961:function(e,t,r){r.d(t,{K:function(){return a}});const a=JSON.parse('{"repo":"aedart/ion","colorMode":"light","logo":"/images/icon/apple-touch-icon.png","editLink":true,"editLinkText":"Edit page","docsRepo":"https://github.com/aedart/ion","docsBranch":"main","docsDir":"docs","lastUpdated":true,"lastUpdatedText":"Last Updated","navbar":[{"text":"Packages","link":"/archive/current/packages/"},{"text":"Archive","link":"/archive","children":[{"text":"next","link":"/archive/next"},{"text":"current","link":"/archive/current"}]},{"text":"Changelog","link":"https://github.com/aedart/ion/blob/main/CHANGELOG.md"}],"sidebar":{"/archive/next":[{"text":"Version 1.x","collapsible":true,"children":["/archive/next/"]}],"/archive/current":[{"text":"Version 0.x","collapsible":true,"children":["/archive/current/","/archive/current/upgrade-guide","/archive/current/contribution-guide","/archive/current/security","/archive/current/code-of-conduct","/archive/current/origin"]},{"text":"Packages","collapsible":true,"children":["/archive/current/packages/",{"text":"Contracts","collapsible":true,"children":["/archive/current/packages/contracts/","/archive/current/packages/contracts/install"]},{"text":"Support","collapsible":true,"children":["/archive/current/packages/support/","/archive/current/packages/support/install",{"text":"Arrays","collapsible":true,"children":["/archive/current/packages/support/arrays/","/archive/current/packages/support/arrays/includesAll","/archive/current/packages/support/arrays/includesAny","/archive/current/packages/support/arrays/isArrayLike","/archive/current/packages/support/arrays/isConcatSpreadable","/archive/current/packages/support/arrays/isSafeArrayLike","/archive/current/packages/support/arrays/isTypedArray","/archive/current/packages/support/arrays/merge"]},{"text":"Concerns","collapsible":true,"children":["/archive/current/packages/support/concerns/","/archive/current/packages/support/concerns/prerequisites","/archive/current/packages/support/concerns/concernClass","/archive/current/packages/support/concerns/usage","/archive/current/packages/support/concerns/aliases","/archive/current/packages/support/concerns/conflictResolution","/archive/current/packages/support/concerns/booting","/archive/current/packages/support/concerns/hooks","/archive/current/packages/support/concerns/edgeCases","/archive/current/packages/support/concerns/jsdoc"]},{"text":"Exceptions","collapsible":true,"children":["/archive/current/packages/support/exceptions/","/archive/current/packages/support/exceptions/configureCustomError","/archive/current/packages/support/exceptions/configureStackTrace","/archive/current/packages/support/exceptions/getErrorMessage","/archive/current/packages/support/exceptions/customErrors"]},{"text":"Meta","collapsible":true,"children":["/archive/current/packages/support/meta/","/archive/current/packages/support/meta/prerequisites","/archive/current/packages/support/meta/supported","/archive/current/packages/support/meta/setAndGet","/archive/current/packages/support/meta/inheritance","/archive/current/packages/support/meta/outsideChanges","/archive/current/packages/support/meta/tc39","/archive/current/packages/support/meta/targetMeta"]},{"text":"Mixins","collapsible":true,"children":["/archive/current/packages/support/mixins/","/archive/current/packages/support/mixins/newMixin","/archive/current/packages/support/mixins/apply","/archive/current/packages/support/mixins/instanceof","/archive/current/packages/support/mixins/inheritance","/archive/current/packages/support/mixins/onward"]},{"text":"Object","collapsible":true,"children":["/archive/current/packages/support/objects/","/archive/current/packages/support/objects/forget","/archive/current/packages/support/objects/forgetAll","/archive/current/packages/support/objects/get","/archive/current/packages/support/objects/has","/archive/current/packages/support/objects/hasAll","/archive/current/packages/support/objects/hasAny","/archive/current/packages/support/objects/hasUniqueId","/archive/current/packages/support/objects/isCloneable","/archive/current/packages/support/objects/isPopulatable","/archive/current/packages/support/objects/isset","/archive/current/packages/support/objects/merge","/archive/current/packages/support/objects/populate","/archive/current/packages/support/objects/set","/archive/current/packages/support/objects/uniqueId"]},{"text":"Reflections","collapsible":true,"children":["/archive/current/packages/support/reflections/","/archive/current/packages/support/reflections/assertHasPrototypeProperty","/archive/current/packages/support/reflections/classLooksLike","/archive/current/packages/support/reflections/classOwnKeys","/archive/current/packages/support/reflections/getAllParentsOfClass","/archive/current/packages/support/reflections/getClassPropertyDescriptor","/archive/current/packages/support/reflections/getClassPropertyDescriptors","/archive/current/packages/support/reflections/getConstructorName","/archive/current/packages/support/reflections/getNameOrDesc","/archive/current/packages/support/reflections/getParentOfClass","/archive/current/packages/support/reflections/hasAllMethods","/archive/current/packages/support/reflections/hasMethod","/archive/current/packages/support/reflections/hasPrototypeProperty","/archive/current/packages/support/reflections/isConstructor","/archive/current/packages/support/reflections/isKeySafe","/archive/current/packages/support/reflections/isKeyUnsafe","/archive/current/packages/support/reflections/isSubclass","/archive/current/packages/support/reflections/isSubclassOrLooksLike","/archive/current/packages/support/reflections/isWeakKind"]},{"text":"Misc","collapsible":true,"children":["/archive/current/packages/support/misc/","/archive/current/packages/support/misc/descTag","/archive/current/packages/support/misc/empty","/archive/current/packages/support/misc/isKey","/archive/current/packages/support/misc/isPrimitive","/archive/current/packages/support/misc/isPropertyKey","/archive/current/packages/support/misc/isset","/archive/current/packages/support/misc/mergeKeys","/archive/current/packages/support/misc/toWeakRef"]}]},{"text":"Vuepress Utils","collapsible":true,"children":["/archive/current/packages/vuepress-utils/","/archive/current/packages/vuepress-utils/install",{"text":"Navigation","collapsible":true,"children":["/archive/current/packages/vuepress-utils/navigation/archive"]},{"text":"Plugins","collapsible":true,"children":["/archive/current/packages/vuepress-utils/plugins/last-updated"]},{"text":"Components","collapsible":true,"children":["/archive/current/packages/vuepress-utils/components/version-disclaimer"]}]},"/archive/current/packages/xyz/"]}]},"locales":{"/":{"selectLanguageName":"English"}},"colorModeSwitch":true,"selectLanguageText":"Languages","selectLanguageAriaLabel":"Select language","sidebarDepth":2,"contributors":true,"contributorsText":"Contributors","notFound":["There\'s nothing here.","How did we get here?","That\'s a Four-Oh-Four.","Looks like we\'ve got some broken links."],"backToHome":"Take me home","openInNewWindow":"open in new window","toggleColorMode":"toggle color mode","toggleSidebar":"toggle sidebar"}')},2950:function(e,t,r){r.d(t,{A:function(){return c}});var a=r(641),s=r(6167),i=r(3456),l=r(6285),c=(0,a.pM)({__name:"LastUpdatedPlugin",setup(e){return(0,a.sV)((()=>{var e,t,r,s;const c=(0,i.BV)(),n=null!=(t=null==(e=c.value.git)?void 0:e.updatedTime)?t:null;if(!n)return;let o=null!=(r=c.value.lastUpdatedDateFormat)?r:"yyyy-LL-dd HH:mm:ss",p=null!=(s=c.value.lastUpdatedDateOptions)?s:{},u=l.c9.fromMillis(n,p).toFormat(o);(0,a.dY)((()=>{var e;const t=document.querySelector(".last-updated > span.meta-item-info");if(!t)return void console.warn("Unable to find .last-updated DOM element");t.innerHTML=u;let r=null!=(e=l.c9.fromMillis(n).toRelative())?e:"";t.setAttribute("title",r)}))})),(e,t)=>((0,a.uX)(),(0,a.Wv)(s.A))}})}},function(e){e.O(0,[170,4475],(function(){return 8731,e(e.s=8731)})),e.O()}]);
\ No newline at end of file
diff --git a/assets/js/apply.html.e3961839.js b/assets/js/apply.html.e3961839.js
new file mode 100644
index 00000000..6f424d38
--- /dev/null
+++ b/assets/js/apply.html.e3961839.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6262],{5126:function(n,s,a){a.r(s),a.d(s,{comp:function(){return p},data:function(){return c}});var e=a(641);const i=[(0,e.Fv)('
',7)],t={};var p=(0,a(6262).A)(t,[["render",function(n,s){return(0,e.uX)(),(0,e.CE)("div",null,i)}]]);const c=JSON.parse('{"path":"/archive/current/packages/support/mixins/apply.html","title":"Apply Mixins","lang":"en-GB","frontmatter":{"title":"Apply Mixins","description":"How to apply mixins.","sidebarDepth":0},"headers":[{"level":2,"title":"Extending Superclass","slug":"extending-superclass","link":"#extending-superclass","children":[]}],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/mixins/apply.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/archive.html.822a3aab.js b/assets/js/archive.html.822a3aab.js
new file mode 100644
index 00000000..bd65947f
--- /dev/null
+++ b/assets/js/archive.html.822a3aab.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3100],{4655:function(n,s,e){e.r(s),e.d(s,{comp:function(){return m},data:function(){return k}});var a=e(641);const t=(0,a.Lk)("h1",{id:"archive",tabindex:"-1"},[(0,a.Lk)("a",{class:"header-anchor",href:"#archive"},[(0,a.Lk)("span",null,"Archive")])],-1),i=(0,a.Lk)("p",null,[(0,a.eW)("The "),(0,a.Lk)("code",null,"Archive"),(0,a.eW)(' component is a helper that keeps track of collections of pages in an "archive" ('),(0,a.Lk)("em",null,"exactly like this site"),(0,a.eW)('). It operates on the notion that there is always a "current" and "next" collection of pages. It can be used to structure documentation for various versions of your application, components, packages...etc.')],-1),o={class:"table-of-contents"},c=(0,a.Fv)('
The following illustrates a possible archive structure of your documentation. Notice the "current" and "next" directories. These two directories are essential for the Archive component. Their names can be configured (shown later). Each of the directories contains a collection of pages.
Each Archive component is dependent on having its structure defined by means of PagesCollection components. As such, to represent the "current" collection, you must create a new PagesCollection instance. Use the static make() method to create a new instance. It accepts 3 arguments:
name: string Name or title of the collection.
path: string The relative path in the archive to the collection.
pages: SidebarConfigArray = [] An array of pages or group of pages. Each page's path is relative to the collection's path.
The path argument of a pages collection will automatically be changed, by the Archive component, if the collection is marked as the "current" or "next" collection (covered in next section).
Once you have your "current" and "next" collections defined, you can create a new Archive instance. Use the static make() method to create a new instance. It accepts 3 arguments:
current: PagesCollection The collection to be marked as the "current".
next: PagesCollection The collection to be marked as the "next".
collections: PagesCollection[] = [] Array of all available collections, including "next" and "current".
// E.g. inside /.vuepress/my_archive/index.ts\nimport{PagesCollection}from"@aedart/vuepress-utils/contracts";\nimport{Archive}from"@aedart/vuepress-utils/navigation";\nimport v3x from"./v3x.ts";\nimport v4x from"./v4x.ts";\nimport v5x from"./v5x.ts";\nimport v6x from"./v6x.ts";\n\n// Defined the "current" colelction \nconstCURRENT: PagesCollection = v5x;\n\n// Defined the "next" colelction\nconstNEXT: PagesCollection = v6x;\n\n// Define all collections... next and current should also be part of this...\nconstALL: PagesCollection[]=[\n NEXT,\n CURRENT,\n v4x,\n v3x,\n // ... etc\n];\n\n// Finally, create and export your archive with "current" and "next" \nconst archive = Archive.make(CURRENT,NEXT,ALL);\narchive.path ='/my_archive';\n\nexportdefault archive;\n
Whenever a collection is marked as "current" or "next", its path is automatically changed to /current or /next. This means that the full path of those collections will be the archive's path + current or next, e.g.
/archive/current
/archive/next
To change these paths, specify the currentPath and nextPath properties in your Archive instance.
When you change the "current" and "next" paths in your archive, then the directory structure MUST reflect these names. From the above example, the archive's directory structure should now be the following:
Use can review the source code and configuration of this site, as a complete example of how the Archive component can be used.
',3),v={};var m=(0,e(6262).A)(v,[["render",function(n,s){const e=(0,a.g2)("router-link"),v=(0,a.g2)("ExternalLinkIcon");return(0,a.uX)(),(0,a.CE)("div",null,[t,i,(0,a.Lk)("nav",o,[(0,a.Lk)("ul",null,[(0,a.Lk)("li",null,[(0,a.bF)(e,{to:"#directory-structure"},{default:(0,a.k6)((()=>[(0,a.eW)("Directory Structure")])),_:1})]),(0,a.Lk)("li",null,[(0,a.bF)(e,{to:"#collections"},{default:(0,a.k6)((()=>[(0,a.eW)("Collections")])),_:1})]),(0,a.Lk)("li",null,[(0,a.bF)(e,{to:"#archive-instance"},{default:(0,a.k6)((()=>[(0,a.eW)("Archive Instance")])),_:1}),(0,a.Lk)("ul",null,[(0,a.Lk)("li",null,[(0,a.bF)(e,{to:"#name-path"},{default:(0,a.k6)((()=>[(0,a.eW)("Name & Path")])),_:1})]),(0,a.Lk)("li",null,[(0,a.bF)(e,{to:"#current-next"},{default:(0,a.k6)((()=>[(0,a.eW)("Current & Next")])),_:1})])])]),(0,a.Lk)("li",null,[(0,a.bF)(e,{to:"#vuepress-config-file"},{default:(0,a.k6)((()=>[(0,a.eW)("Vuepress Config File")])),_:1})]),(0,a.Lk)("li",null,[(0,a.bF)(e,{to:"#onward"},{default:(0,a.k6)((()=>[(0,a.eW)("Onward")])),_:1})])])]),c,(0,a.Lk)("p",null,[(0,a.eW)("To put it all together, in your "),(0,a.Lk)("a",l,[(0,a.eW)("Config File"),(0,a.bF)(v)]),(0,a.eW)(", import your archive instance. Inside your "),p,(0,a.eW)(" settings, you can create a dropdown representation of your archive, by invoking the "),r,(0,a.eW)(" method. A sidebar configuration can be created via the "),u,(0,a.eW)(" method.")]),d])}]]);const k=JSON.parse('{"path":"/archive/current/packages/vuepress-utils/navigation/archive.html","title":"Archive","lang":"en-GB","frontmatter":{"title":"Archive","description":"Archive Structure and Navigation","sidebarDepth":0},"headers":[{"level":2,"title":"Directory Structure","slug":"directory-structure","link":"#directory-structure","children":[]},{"level":2,"title":"Collections","slug":"collections","link":"#collections","children":[]},{"level":2,"title":"Archive Instance","slug":"archive-instance","link":"#archive-instance","children":[{"level":3,"title":"Name & Path","slug":"name-path","link":"#name-path","children":[]},{"level":3,"title":"Current & Next","slug":"current-next","link":"#current-next","children":[]}]},{"level":2,"title":"Vuepress Config File","slug":"vuepress-config-file","link":"#vuepress-config-file","children":[]},{"level":2,"title":"Onward","slug":"onward","link":"#onward","children":[]}],"git":{"updatedTime":1706259575000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1},{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/vuepress-utils/navigation/archive.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/assertHasPrototypeProperty.html.47d85a67.js b/assets/js/assertHasPrototypeProperty.html.47d85a67.js
new file mode 100644
index 00000000..72a280eb
--- /dev/null
+++ b/assets/js/assertHasPrototypeProperty.html.47d85a67.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[8925],{3644:function(e,t,a){a.r(t),a.d(t,{comp:function(){return u},data:function(){return d}});var s=a(641);const n={id:"asserthasprototypeproperty",tabindex:"-1"},r={class:"header-anchor",href:"#asserthasprototypeproperty"},o=(0,s.Lk)("code",null,"assertHasPrototypeProperty",-1),p=(0,s.Lk)("p",null,[(0,s.eW)("Assert that given target object has a "),(0,s.Lk)("code",null,"prototype"),(0,s.eW)(" property defined. Throws a "),(0,s.Lk)("code",null,"TypeError"),(0,s.eW)(" if target object does not have a "),(0,s.Lk)("code",null,"prototype"),(0,s.eW)(" property")],-1),l=(0,s.Lk)("code",null,"hasPrototypeProperty",-1),c=(0,s.Fv)('
',1),i={};var u=(0,a(6262).A)(i,[["render",function(e,t){const a=(0,s.g2)("Badge"),i=(0,s.g2)("RouteLink");return(0,s.uX)(),(0,s.CE)("div",null,[(0,s.Lk)("h1",n,[(0,s.Lk)("a",r,[(0,s.Lk)("span",null,[o,(0,s.eW)(),(0,s.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),p,(0,s.Lk)("p",null,[(0,s.Lk)("em",null,[(0,s.eW)("See "),(0,s.bF)(i,{to:"/archive/current/packages/support/reflections/hasPrototypeProperty.html"},{default:(0,s.k6)((()=>[l])),_:1}),(0,s.eW)(" for details.")])]),c])}]]);const d=JSON.parse('{"path":"/archive/current/packages/support/reflections/assertHasPrototypeProperty.html","title":"Assert Has Prototype Prop.","lang":"en-GB","frontmatter":{"title":"Assert Has Prototype Prop.","description":"Assert that object has a \\"prototype\\" property.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/assertHasPrototypeProperty.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/booting.html.7fb86557.js b/assets/js/booting.html.7fb86557.js
new file mode 100644
index 00000000..24567b29
--- /dev/null
+++ b/assets/js/booting.html.7fb86557.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[86],{5008:function(n,s,a){a.r(s),a.d(s,{comp:function(){return d},data:function(){return k}});var e=a(641);const t=(0,e.Lk)("h1",{id:"booting",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#booting"},[(0,e.Lk)("span",null,"Booting")])],-1),o=(0,e.Lk)("em",null,"ONLY",-1),c={href:"https://en.wikipedia.org/wiki/Lazy_initialization",target:"_blank",rel:"noopener noreferrer"},p=(0,e.Fv)('
classContactsApiextendsAbstractConcern{\n getusers(){/* ...not shown here... */}\n}\n\n@use(ContactsApi)// Concern is NOT instantiated\nclassUsersRegistry{}\n\nconst users =(newUsersRegistry()).users;// Concern is instantiated\n
If you wish to boot all concerns, use the bootAllConcerns() utility.
import{ use, bootAllConcerns }from"@aedart/support/concerns";\n\n@use(\n ConcernA,\n ConcernB,\n ConcernC,\n)\nclassTarget{\n constructor(){\n bootAllConcerns(this);\n }\n}\n\nconst instance =newTarget();// All concerns are initialised\n
',3),r={};var d=(0,a(6262).A)(r,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon"),r=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("By default, a concern class is "),o,(0,e.eW)(' instantiated when you interact with its properties or methods, which have been "aliased" into a target class ('),(0,e.Lk)("em",null,[(0,e.eW)("aka. "),(0,e.Lk)("a",c,[(0,e.eW)("lazy booting"),(0,e.bF)(a)])]),(0,e.eW)(").")]),p,(0,e.Lk)("div",i,[l,(0,e.Lk)("p",null,[(0,e.eW)("See "),(0,e.bF)(r,{to:"/archive/current/packages/support/concerns/usage.html#manual-interaction"},{default:(0,e.k6)((()=>[(0,e.eW)("Manual interaction")])),_:1}),(0,e.eW)(" for details.")])]),u])}]]);const k=JSON.parse('{"path":"/archive/current/packages/support/concerns/booting.html","title":"Booting","lang":"en-GB","frontmatter":{"title":"Booting","description":"How concerns are booted","sidebarDepth":0},"headers":[{"level":2,"title":"Manual Booting","slug":"manual-booting","link":"#manual-booting","children":[{"level":3,"title":"Boot All Concerns","slug":"boot-all-concerns","link":"#boot-all-concerns","children":[]}]}],"git":{"updatedTime":1709641376000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/concerns/booting.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/classLooksLike.html.a8409fa2.js b/assets/js/classLooksLike.html.a8409fa2.js
new file mode 100644
index 00000000..19c70490
--- /dev/null
+++ b/assets/js/classLooksLike.html.a8409fa2.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[2023],{1274:function(s,n,a){a.r(n),a.d(n,{comp:function(){return r},data:function(){return k}});var e=a(641);const t={id:"classlookslike",tabindex:"-1"},p={class:"header-anchor",href:"#classlookslike"},o=(0,e.Lk)("code",null,"classLooksLike",-1),c=(0,e.Lk)("p",null,[(0,e.eW)("Determines if a target class "),(0,e.Lk)("em",null,'"looks like"'),(0,e.eW)(' the provided class "blueprint".')],-1),l={class:"table-of-contents"},i=(0,e.Fv)('
The class "blueprint" is an object that defines the expected members (property keys) of a target class. All defined members must exist in target class' prototype, before the classLooksLike() returns true.
You can specify either or both of the following properties in a class blueprint object:
members: PropertyKey[] - (optional) Properties or methods expected to exist in class' prototype.
staticMembers: PropertyKey[] - (optional) Properties or methods expected to exist in class as static members.
Note:If you do not specify either members or staticMembers, then a TypeError is thrown.
classLooksLike() traverses target class' prototype chain. This means that you can compare a subclass against a blueprint and inherited members will automatically be included in the check.
',13),u={};var r=(0,a(6262).A)(u,[["render",function(s,n){const a=(0,e.g2)("Badge"),u=(0,e.g2)("router-link");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[o,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),c,(0,e.Lk)("nav",l,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(u,{to:"#arguments"},{default:(0,e.k6)((()=>[(0,e.eW)("Arguments")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(u,{to:"#class-blueprint"},{default:(0,e.k6)((()=>[(0,e.eW)("Class Blueprint")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(u,{to:"#recursive"},{default:(0,e.k6)((()=>[(0,e.eW)("Recursive")])),_:1})])])]),i])}]]);const k=JSON.parse('{"path":"/archive/current/packages/support/reflections/classLooksLike.html","title":"Class Looks Like","lang":"en-GB","frontmatter":{"title":"Class Looks Like","description":"Determine if a class looks like blueprint.","sidebarDepth":0},"headers":[{"level":2,"title":"Arguments","slug":"arguments","link":"#arguments","children":[]},{"level":2,"title":"Class Blueprint","slug":"class-blueprint","link":"#class-blueprint","children":[]},{"level":2,"title":"Recursive","slug":"recursive","link":"#recursive","children":[]}],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/classLooksLike.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/classOwnKeys.html.083ccde1.js b/assets/js/classOwnKeys.html.083ccde1.js
new file mode 100644
index 00000000..4102dc4d
--- /dev/null
+++ b/assets/js/classOwnKeys.html.083ccde1.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[984],{5491:function(s,n,a){a.r(n),a.d(n,{comp:function(){return l},data:function(){return r}});var e=a(641);const t={id:"classownkeys",tabindex:"-1"},o={class:"header-anchor",href:"#classownkeys"},c=(0,e.Lk)("code",null,"classOwnKeys",-1),p=(0,e.Fv)('
Returns property keys that are defined target class's prototype. It accepts the following arguments:
target: ConstructorOrAbstractConstructor - The target class
recursive: boolean = false - (optional) If true, then target's prototype chain is traversed and all property keys are returned.
The classOwnKeys() function does not return static members of a target class.
',6),i={};var l=(0,a(6262).A)(i,[["render",function(s,n){const a=(0,e.g2)("Badge");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",o,[(0,e.Lk)("span",null,[c,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),p])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/reflections/classOwnKeys.html","title":"Class Own Keys","lang":"en-GB","frontmatter":{"title":"Class Own Keys","description":"Get property keys of target class.","sidebarDepth":0},"headers":[{"level":2,"title":"Limitation","slug":"limitation","link":"#limitation","children":[]}],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/classOwnKeys.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/code-of-conduct.html.2cd0f919.js b/assets/js/code-of-conduct.html.2cd0f919.js
new file mode 100644
index 00000000..6c980999
--- /dev/null
+++ b/assets/js/code-of-conduct.html.2cd0f919.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[2846],{3208:function(e,n,o){o.r(n),o.d(n,{comp:function(){return i},data:function(){return r}});var t=o(641);const a=[(0,t.Fv)('
Be nice... be fair! Writing free Open Source software often means spending time developing after-hours, and in weekends. Chances are pretty good that you yourself are involved in one or many Open Source projects and already know how time-consuming it can be. In any case, the following constitutes the code of conduct used by Ion:
Be patient, nice and fair.
Be helpful and constructive.
Your words and actions must be free of harassment, harmful deeds or remarks, and malicious intent.
Respect the opinions of others, even if they contradict yours.
Participants can be subject to consequences, if the code of conduct is not upheld. Such consequences include, but not limited to, warnings, and banning from further participation.
',5)],c={};var i=(0,o(6262).A)(c,[["render",function(e,n){return(0,t.uX)(),(0,t.CE)("div",null,a)}]]);const r=JSON.parse('{"path":"/archive/current/code-of-conduct.html","title":"Code of Conduct","lang":"en-GB","frontmatter":{"description":"Code of Conduct - Ion","sidebarDepth":0},"headers":[{"level":2,"title":"Consequences","slug":"consequences","link":"#consequences","children":[]}],"git":{"updatedTime":1679232326000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/code-of-conduct.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/concernClass.html.392f500d.js b/assets/js/concernClass.html.392f500d.js
new file mode 100644
index 00000000..2a0c5d5f
--- /dev/null
+++ b/assets/js/concernClass.html.392f500d.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9628],{6482:function(n,s,a){a.r(s),a.d(s,{comp:function(){return R},data:function(){return P}});var e=a(641);const t=(0,e.Lk)("h1",{id:"concern-class",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#concern-class"},[(0,e.Lk)("span",null,"Concern Class")])],-1),o=(0,e.Lk)("p",null,"This chapter shows how to create a new concern class.",-1),c={class:"table-of-contents"},i=(0,e.Fv)('
Static methods and properties are NOT "aliased" into target class.
At the moment, such a feature is not supported by the concerns' mechanism.This may become available in the future, but presently you SHOULD NOT rely on static members becoming available for aliasing.
Should you require initialisation logic, then you can overwrite the constructor in your concern class. A concern's constructor is only given the target class instance as argument.
',3),q=(0,e.Fv)('
classRecordingextendsAbstractConcern{\n constructor(owner){\n super(owner);\n \n // ...perform your initialisation here...\n }\n}\n
',1),I={};var R=(0,a(6262).A)(I,[["render",function(n,s){const a=(0,e.g2)("router-link"),I=(0,e.g2)("RouteLink"),R=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,o,(0,e.Lk)("nav",c,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#inherit-from-abstractconcern"},{default:(0,e.k6)((()=>[(0,e.eW)("Inherit from AbstractConcern")])),_:1}),(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#private-members"},{default:(0,e.k6)((()=>[(0,e.eW)("Private Members")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#static-members"},{default:(0,e.k6)((()=>[(0,e.eW)("Static Members")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#transpilers"},{default:(0,e.k6)((()=>[(0,e.eW)("Transpilers")])),_:1})])])]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#customise-alias-members"},{default:(0,e.k6)((()=>[(0,e.eW)('Customise "alias" members')])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#concern-owner-instance"},{default:(0,e.k6)((()=>[(0,e.eW)("Concern Owner instance")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#constructor"},{default:(0,e.k6)((()=>[(0,e.eW)("Constructor")])),_:1})])])]),i,(0,e.Lk)("p",null,[(0,e.eW)("By default, all the public properties and methods ("),p,(0,e.eW)(") are made available for "),(0,e.bF)(I,{to:"/archive/current/packages/support/concerns/aliases.html"},{default:(0,e.k6)((()=>[(0,e.eW)('"aliasing"')])),_:1}),(0,e.eW)(" into a target class. To configure which members should be made available for aliasing, see "),l,(0,e.eW)(".")]),r,(0,e.Lk)("div",u,[d,(0,e.Lk)("p",null,[(0,e.eW)("Some transpilers, like "),(0,e.Lk)("a",k,[(0,e.eW)("Babel"),(0,e.bF)(R)]),(0,e.eW)(" and "),(0,e.Lk)("a",m,[(0,e.eW)("TypeScript"),(0,e.bF)(R)]),(0,e.eW)(", automatically move property declarations into the class' "),v,(0,e.eW)(". For instance:")]),b,(0,e.Lk)("p",null,[(0,e.eW)('When this happens, properties cannot be "aliased". The concern mechanisms relies on the class\' prototype for reading what properties are available. To overcome such an issue, you can use '),(0,e.Lk)("a",h,[(0,e.eW)("getters"),(0,e.bF)(R)]),(0,e.eW)(" and "),(0,e.Lk)("a",g,[(0,e.eW)("setters"),(0,e.bF)(R)]),(0,e.eW)(" instead.")]),f]),w,(0,e.Lk)("p",null,[(0,e.eW)("If you wish to customise what properties and methods "),y,(0,e.eW)(" be available for "),(0,e.bF)(I,{to:"/archive/current/packages/support/concerns/aliases.html"},{default:(0,e.k6)((()=>[(0,e.eW)("aliasing")])),_:1}),(0,e.eW)(" when used by a target class, overwrite the static "),L,(0,e.eW)(" method.")]),W,(0,e.Lk)("div",C,[F,(0,e.Lk)("p",null,[(0,e.eW)("Even if you do customise what properties and methods are available for aliasing, the returned property keys of the "),j,(0,e.eW)(" method can be overruled, via "),(0,e.bF)(I,{to:"/archive/current/packages/support/concerns/conflictResolution.html"},{default:(0,e.k6)((()=>[(0,e.eW)("conflict resolution")])),_:1}),(0,e.eW)("!")]),(0,e.Lk)("p",null,[(0,e.eW)("If you truly wish to prevent certain properties or methods from being aliased into a target class, then you "),_,(0,e.eW)(" declare them as "),(0,e.Lk)("a",S,[(0,e.eW)("private"),(0,e.bF)(R)]),(0,e.eW)(".")])]),x,(0,e.Lk)("p",null,[(0,e.eW)("The "),A,(0,e.eW)(" property gives you direct access to the target class instance, in your concern. This allows you to create interaction between the target instance and your concern, which can be usefully in any number of situations. For instance, you can use the "),O,(0,e.eW)(" to create a "),(0,e.Lk)("a",M,[(0,e.eW)("fluent design"),(0,e.bF)(R)]),(0,e.eW)(" of your utilities.")]),T,(0,e.Lk)("p",null,[(0,e.Lk)("em",null,[(0,e.eW)("See "),(0,e.bF)(I,{to:"/archive/current/packages/support/concerns/booting.html"},{default:(0,e.k6)((()=>[(0,e.eW)("booting")])),_:1}),(0,e.eW)(" for additional information.")])]),q])}]]);const P=JSON.parse('{"path":"/archive/current/packages/support/concerns/concernClass.html","title":"Concern Class","lang":"en-GB","frontmatter":{"title":"Concern Class","description":"How to define a new concern class.","sidebarDepth":0},"headers":[{"level":2,"title":"Inherit from AbstractConcern","slug":"inherit-from-abstractconcern","link":"#inherit-from-abstractconcern","children":[{"level":3,"title":"Private Members","slug":"private-members","link":"#private-members","children":[]},{"level":3,"title":"Static Members","slug":"static-members","link":"#static-members","children":[]},{"level":3,"title":"Transpilers","slug":"transpilers","link":"#transpilers","children":[]}]},{"level":2,"title":"Customise \\"alias\\" members","slug":"customise-alias-members","link":"#customise-alias-members","children":[]},{"level":2,"title":"Concern Owner instance","slug":"concern-owner-instance","link":"#concern-owner-instance","children":[]},{"level":2,"title":"Constructor","slug":"constructor","link":"#constructor","children":[]}],"git":{"updatedTime":1709641376000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/concerns/concernClass.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/configureCustomError.html.a937c58f.js b/assets/js/configureCustomError.html.a937c58f.js
new file mode 100644
index 00000000..e6525f7a
--- /dev/null
+++ b/assets/js/configureCustomError.html.a937c58f.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[5807],{3866:function(n,s,e){e.r(s),e.d(s,{comp:function(){return i},data:function(){return u}});var a=e(641);const t=(0,a.Fv)('
',3),p={class:"custom-container warning"},i=(0,e.Lk)("p",{class:"custom-container-title"},"WARNING",-1),u=(0,e.Lk)("code",null,"stack",-1),l={href:"https://github.com/tc39/proposal-error-stacks",target:"_blank",rel:"noopener noreferrer"},d=(0,e.Lk)("code",null,"stack",-1),k=(0,e.Lk)("code",null,"configureStackTrace()",-1),m={};var g=(0,s(6262).A)(m,[["render",function(n,a){const s=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Captures a new stack trace and sets given Error's "),(0,e.Lk)("a",r,[o,(0,e.bF)(s)]),(0,e.eW)(" property.")]),c,(0,e.Lk)("div",p,[i,(0,e.Lk)("p",null,[(0,e.eW)("The "),u,(0,e.eW)(" is "),(0,e.Lk)("a",l,[(0,e.eW)("not yet an official feature"),(0,e.bF)(s)]),(0,e.eW)(", even though it's supported by many major browsers and Node.js. If you are working with custom errors, you might not need to capture and set the "),d,(0,e.eW)(" property. Therefore, you should only use "),k,(0,e.eW)(" in situations when your JavaScript environment does not support stack traces in custom errors.")])])])}]]);const v=JSON.parse('{"path":"/archive/current/packages/support/exceptions/configureStackTrace.html","title":"Configure Stack Trace","lang":"en-GB","frontmatter":{"title":"Configure Stack Trace","description":"Configuration error stack trace.","sidebarDepth":0},"headers":[{"level":2,"title":"Arguments","slug":"arguments","link":"#arguments","children":[]}],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/exceptions/configureStackTrace.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/conflictResolution.html.84b254f4.js b/assets/js/conflictResolution.html.84b254f4.js
new file mode 100644
index 00000000..c2a79fac
--- /dev/null
+++ b/assets/js/conflictResolution.html.84b254f4.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[7428],{7321:function(n,s,a){a.r(s),a.d(s,{comp:function(){return p},data:function(){return l}});var e=a(641);const t=(0,e.Lk)("h1",{id:"conflict-resolution",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#conflict-resolution"},[(0,e.Lk)("span",null,"Conflict Resolution")])],-1),o={class:"table-of-contents"},c=(0,e.Fv)('
A concern class may ONLY occur once in a target class' prototype chain. This is a core feature of the concerns mechanism and cannot be circumvented. However, sometimes you may find yourself in situations where different injected concern classes define the same property or method name. When this happens an AliasConflictError is thrown.
To prevent a concern class from defining any aliases inside a target class, set the allowAliases option to false.
import{ getConcernsContainer }from"@aedart/support/concerns";\n\n@use(\n Label,\n {\n concern: Category,\n allowAliases:false// Category's "name" is NOT aliased in target\n }\n)\nclassBattery{}\n\nconst instance =newBattery();\ninstance.name ='AA';\n\n// Interact with Category concern to set "name"\ngetConcernsContainer(instance).get(Category).name ='Rechargeable';\n
You can also use a shorthand version to specify a concern injection configuration, via an array. The first array value must always be the concern class that must be injected. The second value can either be an aliases object, or boolean value for setting the allowAliases option.
',3),d=(0,n.Lk)("h2",{id:"feature-request",tabindex:"-1"},[(0,n.Lk)("a",{class:"header-anchor",href:"#feature-request"},[(0,n.Lk)("span",null,"Feature Request")])],-1),c={href:"https://github.com/aedart/ion/issues/new/choose",target:"_blank",rel:"noopener noreferrer"},h={href:"https://github.com/aedart/ion/discussions",target:"_blank",rel:"noopener noreferrer"},p=(0,n.Lk)("h2",{id:"fork-code-and-send-pull-request",tabindex:"-1"},[(0,n.Lk)("a",{class:"header-anchor",href:"#fork-code-and-send-pull-request"},[(0,n.Lk)("span",null,"Fork, code and send pull-request")])],-1),k=(0,n.Lk)("p",null,"If you wish to fix a bug, add new feature, or perhaps change an existing, then please follow this guideline",-1),f=(0,n.Lk)("li",null,"Fork this project",-1),g=(0,n.Lk)("li",null,"Create a new local development branch for the given fix, addition or change",-1),b=(0,n.Lk)("li",null,"Write your code / changes",-1),y=(0,n.Lk)("li",null,[(0,n.eW)("Create executable test-cases ("),(0,n.Lk)("em",null,"prove that your changes are solid!"),(0,n.eW)(")")],-1),m=(0,n.Lk)("li",null,"Commit and push your changes to your fork-repository",-1),L=(0,n.Lk)("li",null,[(0,n.eW)("Send a pull-request with your changes ("),(0,n.Lk)("em",null,'please check "Allow edits from maintainers"'),(0,n.eW)(")")],-1),v={href:"https://en.wikipedia.org/wiki/Beer",target:"_blank",rel:"noopener noreferrer"},W=(0,n.Lk)("p",null,[(0,n.eW)("As soon as I receive the pull-request ("),(0,n.Lk)("em",null,"and have time for it"),(0,n.eW)("), I will review your changes and merge them into this project. If not, I will inform you why I choose not to.")],-1),w={};var q=(0,r(6262).A)(w,[["render",function(e,t){const r=(0,n.g2)("ExternalLinkIcon"),w=(0,n.g2)("router-link"),q=(0,n.g2)("RouteLink");return(0,n.uX)(),(0,n.CE)("div",null,[l,(0,n.Lk)("p",null,[(0,n.eW)("Have you found a defect ( "),(0,n.Lk)("a",o,[(0,n.eW)("bug or design flaw"),(0,n.bF)(r)]),(0,n.eW)(" ), or do you wish improvements? In the following sections, you might find some useful information on how you can help this project. In any case, I thank you for taking the time to help me improve this project's deliverables and overall quality.")]),(0,n.Lk)("nav",i,[(0,n.Lk)("ul",null,[(0,n.Lk)("li",null,[(0,n.bF)(w,{to:"#bug-report"},{default:(0,n.k6)((()=>[(0,n.eW)("Bug Report")])),_:1})]),(0,n.Lk)("li",null,[(0,n.bF)(w,{to:"#security-vulnerability"},{default:(0,n.k6)((()=>[(0,n.eW)("Security Vulnerability")])),_:1})]),(0,n.Lk)("li",null,[(0,n.bF)(w,{to:"#feature-request"},{default:(0,n.k6)((()=>[(0,n.eW)("Feature Request")])),_:1})]),(0,n.Lk)("li",null,[(0,n.bF)(w,{to:"#fork-code-and-send-pull-request"},{default:(0,n.k6)((()=>[(0,n.eW)("Fork, code and send pull-request")])),_:1})])])]),a,(0,n.Lk)("p",null,[(0,n.eW)("If you have found a bug, please report it on "),(0,n.Lk)("a",u,[(0,n.eW)("GitHub"),(0,n.bF)(r)]),(0,n.eW)(". When reporting the bug, do consider the following:")]),s,(0,n.Lk)("p",null,[(0,n.eW)("Please read the "),(0,n.bF)(q,{to:"/archive/current/security.html"},{default:(0,n.k6)((()=>[(0,n.eW)("Security Policy")])),_:1}),(0,n.eW)(".")]),d,(0,n.Lk)("p",null,[(0,n.eW)("If you have an idea for a new feature or perhaps changing an existing, feel free to create a "),(0,n.Lk)("a",c,[(0,n.eW)("feature request"),(0,n.bF)(r)]),(0,n.eW)(". Should you feel unsure whether your idea is good or not, then perhaps you could start a "),(0,n.Lk)("a",h,[(0,n.eW)("discussion"),(0,n.bF)(r)]),(0,n.eW)(".")]),p,k,(0,n.Lk)("ul",null,[f,g,b,y,m,L,(0,n.Lk)("li",null,[(0,n.Lk)("em",null,[(0,n.eW)("Drink a "),(0,n.Lk)("a",v,[(0,n.eW)("Beer"),(0,n.bF)(r)]),(0,n.eW)(" - you earned it")]),(0,n.eW)(" 😃")])]),W])}]]);const F=JSON.parse('{"path":"/archive/current/contribution-guide.html","title":"Contribution Guide","lang":"en-GB","frontmatter":{"description":"How to contribute to Ion","sidebarDepth":0},"headers":[{"level":2,"title":"Bug Report","slug":"bug-report","link":"#bug-report","children":[]},{"level":2,"title":"Security Vulnerability","slug":"security-vulnerability","link":"#security-vulnerability","children":[]},{"level":2,"title":"Feature Request","slug":"feature-request","link":"#feature-request","children":[]},{"level":2,"title":"Fork, code and send pull-request","slug":"fork-code-and-send-pull-request","link":"#fork-code-and-send-pull-request","children":[]}],"git":{"updatedTime":1679232326000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/contribution-guide.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/customErrors.html.03ae048e.js b/assets/js/customErrors.html.03ae048e.js
new file mode 100644
index 00000000..ecfdbe0c
--- /dev/null
+++ b/assets/js/customErrors.html.03ae048e.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[1816],{8394:function(s,n,a){a.r(n),a.d(n,{comp:function(){return u},data:function(){return d}});var e=a(641);const t=(0,e.Lk)("h1",{id:"custom-errors",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#custom-errors"},[(0,e.Lk)("span",null,"Custom Errors")])],-1),o={class:"table-of-contents"},r=(0,e.Fv)('
It is not possible to define a property's getter and setter methods in separate concerns, and thereafter use them in a target class. Despite serving different purposes, the getter and setter share the same property name and are therefore treated as being one and the same property key. The following example will therefore always lead to an AliasConflictError being thrown.
import{ AbstractConcern, use }from"@aedart/support/concerns";\n\nclassAextendsAbstractConcern{\n gettitle(){/* ...not shown.. */}\n}\n\nclassBextendsAbstractConcern{\n settitle(value){/* ...not shown.. */}\n}\n\n@use(\n A,\n B// AliasConflictError - "title" property from A!\n)\nclassPerson{}\n
',3),o=(0,e.Lk)("em",null,"if you intend for such a property to be readable and writable.",-1),i=(0,e.Fv)('
The concerns mechanism will never overwrite existing methods or properties inside a target class - not even when those methods or properties are inherited from a parent class.
import{ AbstractConcern, use }from"@aedart/support/concerns";\n\nclassConnectionextendsAbstractConcern{\n driver(){\n return'special';\n }\n}\n\nclassApi{\n driver(){\n return'default';\n }\n}\n\n@user(Connection)// driver() is NOT aliased - method inherited from Api class!\nclassSailBoatextendsApi{}\n\nconst instance =newSailBoat();\ninstance.driver();// default\n
',3),l=(0,e.Fv)('
import{ AbstractConcern, use }from"@aedart/support/concerns";\n\nclassConnectionextendsAbstractConcern{\n driver(){\n return'special';\n }\n}\n\nclassApi{\n driver(){\n return'default';\n }\n}\n\n@user(\n [Connection,{\n 'driver':'specialDriver'// alias "driver" as "specialDriver"\n }]\n)\nclassSailBoatextendsApi{\n \n // Overwrite inherited method\n driver(){\n // Invoke the "specialDriver"... \n returnthis.specialDriver();\n }\n}\n\nconst instance =newSailBoat();\ninstance.driver();// special\n
In some isolated cases, this might be acceptable for you. Nevertheless, if your application makes heavy use of concerns using other concerns, then your application's overall performance could suffer. You should consider merging multiple concern classes into a single class, if it is reasonable and possible. Alternatively, you can also consider extending existing concern classes. For instance:
Now, whenever the ping() method is invoked, the call stack is slightly reduced:
Game (instance).ping() -> Pong (instance).ping()\n\n("->" represents concerns container instance)\n
',10),u={};var r=(0,a(6262).A)(u,[["render",function(n,s){const a=(0,e.g2)("router-link"),u=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("nav",c,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#getter-setter-declared-in-different-concerns"},{default:(0,e.k6)((()=>[(0,e.eW)("Getter & Setter declared in different concerns")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#inheritance-vs-concern-members"},{default:(0,e.k6)((()=>[(0,e.eW)("Inheritance vs. Concern members")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#concerns-using-other-concerns"},{default:(0,e.k6)((()=>[(0,e.eW)("Concerns using other concerns")])),_:1})])])]),p,(0,e.Lk)("p",null,[(0,e.eW)("You can resolve the above shown issue via a "),(0,e.bF)(u,{to:"/archive/current/packages/support/concerns/conflictResolution.html#resolve-naming-conflicts"},{default:(0,e.k6)((()=>[(0,e.eW)("custom alias")])),_:1}),(0,e.eW)(". But, it is advisable to design your concerns such that the offer appropriate getter and setter methods for a property, in one and the same concern - "),o]),i,(0,e.Lk)("p",null,[(0,e.eW)("The only way to resolve the above shown issue, is by making use of a "),(0,e.bF)(u,{to:"/archive/current/packages/support/concerns/conflictResolution.html#resolve-naming-conflicts"},{default:(0,e.k6)((()=>[(0,e.eW)("custom alias")])),_:1}),(0,e.eW)(" and manually overwrite the inherited method. E.g.")]),l])}]]);const d=JSON.parse('{"path":"/archive/current/packages/support/concerns/edgeCases.html","title":"Edge Cases","lang":"en-GB","frontmatter":{"title":"Edge Cases","description":"A few edge cases when making or using concerns","sidebarDepth":0},"headers":[{"level":2,"title":"Getter & Setter declared in different concerns","slug":"getter-setter-declared-in-different-concerns","link":"#getter-setter-declared-in-different-concerns","children":[]},{"level":2,"title":"Inheritance vs. Concern members","slug":"inheritance-vs-concern-members","link":"#inheritance-vs-concern-members","children":[]},{"level":2,"title":"Concerns using other concerns","slug":"concerns-using-other-concerns","link":"#concerns-using-other-concerns","children":[]}],"git":{"updatedTime":1709641376000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/concerns/edgeCases.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/empty.html.0cbc3fef.js b/assets/js/empty.html.0cbc3fef.js
new file mode 100644
index 00000000..820e0a21
--- /dev/null
+++ b/assets/js/empty.html.0cbc3fef.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3295],{6616:function(n,s,a){a.r(s),a.d(s,{comp:function(){return f},data:function(){return b}});var t=a(641);const p=(0,t.Lk)("h1",{id:"empty",tabindex:"-1"},[(0,t.Lk)("a",{class:"header-anchor",href:"#empty"},[(0,t.Lk)("span",null,[(0,t.Lk)("code",null,"empty")])])],-1),e=(0,t.Lk)("p",null,"Determine if value is empty.",-1),c=(0,t.Lk)("code",null,"isset()",-1),o=(0,t.Fv)('
',2),l={class:"custom-container warning"},u=(0,t.Lk)("p",{class:"custom-container-title"},"Caution",-1),i=(0,t.Lk)("code",null,"empty()",-1),k={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap",target:"_blank",rel:"noopener noreferrer"},r=(0,t.Lk)("code",null,"WeakMap",-1),m={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet",target:"_blank",rel:"noopener noreferrer"},d=(0,t.Lk)("code",null,"WeakSet",-1),v={};var f=(0,a(6262).A)(v,[["render",function(n,s){const a=(0,t.g2)("RouteLink"),v=(0,t.g2)("ExternalLinkIcon");return(0,t.uX)(),(0,t.CE)("div",null,[p,e,(0,t.Lk)("p",null,[(0,t.Lk)("em",null,[(0,t.eW)("See also "),(0,t.bF)(a,{to:"/archive/current/packages/support/misc/isset.html"},{default:(0,t.k6)((()=>[c])),_:1}),(0,t.eW)(".")])]),o,(0,t.Lk)("div",l,[u,(0,t.Lk)("p",null,[i,(0,t.eW)(" is not able to determine if a "),(0,t.Lk)("a",k,[r,(0,t.bF)(v)]),(0,t.eW)(" or "),(0,t.Lk)("a",m,[d,(0,t.bF)(v)]),(0,t.eW)(" is empty.")])])])}]]);const b=JSON.parse('{"path":"/archive/current/packages/support/misc/empty.html","title":"Empty","lang":"en-GB","frontmatter":{"title":"Empty","description":"Determine if value is empty","sidebarDepth":0},"headers":[{"level":2,"title":"WeakMap and WeakSet","slug":"weakmap-and-weakset","link":"#weakmap-and-weakset","children":[]}],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/misc/empty.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/forget.html.678760e4.js b/assets/js/forget.html.678760e4.js
new file mode 100644
index 00000000..8b0e3ba3
--- /dev/null
+++ b/assets/js/forget.html.678760e4.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[4993],{8407:function(n,s,a){a.r(s),a.d(s,{comp:function(){return i},data:function(){return u}});var e=a(641);const t=(0,e.Lk)("h1",{id:"forget",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#forget"},[(0,e.Lk)("span",null,[(0,e.Lk)("code",null,"forget")])])],-1),p=(0,e.Lk)("em",null,"delete",-1),o={href:"https://lodash.com/docs/4.17.15#unset",target:"_blank",rel:"noopener noreferrer"},r=(0,e.Lk)("code",null,"unset",-1),c=(0,e.Fv)('
',1),l={};var i=(0,a(6262).A)(l,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Remove ("),p,(0,e.eW)(") a value in object at given path. "),(0,e.Lk)("em",null,[(0,e.eW)("Method is an alias for "),(0,e.Lk)("a",o,[(0,e.eW)("Lodash "),r,(0,e.bF)(a)]),(0,e.eW)(".")])]),c])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/objects/forget.html","title":"Forget","lang":"en-GB","frontmatter":{"title":"Forget","description":"Forget object key","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/forget.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/forgetAll.html.221e6917.js b/assets/js/forgetAll.html.221e6917.js
new file mode 100644
index 00000000..edf9f941
--- /dev/null
+++ b/assets/js/forgetAll.html.221e6917.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[7922],{8668:function(n,s,a){a.r(s),a.d(s,{comp:function(){return o},data:function(){return l}});var t=a(641);const e=[(0,t.Fv)('
',4),i={};var r=(0,s(6262).A)(i,[["render",function(n,a){const s=(0,e.g2)("ExternalLinkIcon"),i=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Get value in object at given path. "),(0,e.Lk)("em",null,[(0,e.eW)("Method is an alias for "),(0,e.Lk)("a",p,[(0,e.eW)("Lodash "),o,(0,e.bF)(s)]),(0,e.eW)(".")])]),(0,e.Lk)("p",null,[(0,e.Lk)("em",null,[(0,e.eW)("See also "),(0,e.bF)(i,{to:"/archive/current/packages/support/objects/set.html"},{default:(0,e.k6)((()=>[l])),_:1}),(0,e.eW)(".")])]),c])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/objects/get.html","title":"Get","lang":"en-GB","frontmatter":{"title":"Get","description":"Get object value from given path.","sidebarDepth":0},"headers":[{"level":2,"title":"Default Value","slug":"default-value","link":"#default-value","children":[]}],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/get.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/getAllParentsOfClass.html.d8b9749c.js b/assets/js/getAllParentsOfClass.html.d8b9749c.js
new file mode 100644
index 00000000..fc49e205
--- /dev/null
+++ b/assets/js/getAllParentsOfClass.html.d8b9749c.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3503],{7210:function(s,n,a){a.r(n),a.d(n,{comp:function(){return r},data:function(){return u}});var e=a(641);const t={id:"getallparentsofclass",tabindex:"-1"},l={class:"header-anchor",href:"#getallparentsofclass"},c=(0,e.Lk)("code",null,"getAllParentsOfClass",-1),p=(0,e.Fv)('
Returns all parents of target class. It accepts the following arguments:
target: ConstructorOrAbstractConstructor - The target class.
includeTarget: boolean = false - (optional) If true, then given target is included in the output as the first element.
import{ getAllParentsOfClass }from'@aedart/support/reflections';\n\nclassA{}\n\nclassBextendsA{}\n\nclassCextendsB{}\n\ngetAllParentsOfClass(C);// [ B, A ]\ngetAllParentsOfClass(C,true);// [ C, B, A ]\n
',3),o=(0,e.Lk)("code",null,"getParentOfClass()",-1),i={};var r=(0,a(6262).A)(i,[["render",function(s,n){const a=(0,e.g2)("Badge"),i=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",l,[(0,e.Lk)("span",null,[c,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),p,(0,e.Lk)("p",null,[(0,e.Lk)("em",null,[(0,e.eW)("See also "),(0,e.bF)(i,{to:"/archive/current/packages/support/reflections/getParentOfClass.html"},{default:(0,e.k6)((()=>[o])),_:1}),(0,e.eW)(".")])])])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/reflections/getAllParentsOfClass.html","title":"Get All Parents Of Class","lang":"en-GB","frontmatter":{"title":"Get All Parents Of Class","description":"Get all parents of a class","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/getAllParentsOfClass.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/getClassPropertyDescriptor.html.184c403f.js b/assets/js/getClassPropertyDescriptor.html.184c403f.js
new file mode 100644
index 00000000..f86e7b6b
--- /dev/null
+++ b/assets/js/getClassPropertyDescriptor.html.184c403f.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[572],{463:function(s,n,a){a.r(n),a.d(n,{comp:function(){return u},data:function(){return d}});var e=a(641);const t={id:"getclasspropertydescriptor",tabindex:"-1"},p={class:"header-anchor",href:"#getclasspropertydescriptor"},o=(0,e.Lk)("code",null,"getClassPropertyDescriptor",-1),c={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/getOwnPropertyDescriptor",target:"_blank",rel:"noopener noreferrer"},r=(0,e.Lk)("code",null,"PropertyDescriptor",-1),i=(0,e.Fv)('
It accepts the following arguments:
target: ConstructorOrAbstractConstructor - The target class.
key: PropertyKey - Name of the property.
import{ getClassPropertyDescriptor }from'@aedart/support/reflections';\n\nclassA{\n setname(v){}\n getname(){}\n}\n\ngetClassPropertyDescriptor(A,'name');// see "output"...\n
The above show example results in the given output:
getClassPropertyDescriptor() returns undefined if requested key does not exist in class' prototype.
Caution
getClassPropertyDescriptor() throws TypeError if target does not have a prototype property.
',7),l={};var u=(0,a(6262).A)(l,[["render",function(s,n){const a=(0,e.g2)("Badge"),l=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[o,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,e.Lk)("p",null,[(0,e.eW)("Returns "),(0,e.Lk)("a",c,[r,(0,e.bF)(l)]),(0,e.eW)(", from target's prototype that matches given property key.")]),i])}]]);const d=JSON.parse('{"path":"/archive/current/packages/support/reflections/getClassPropertyDescriptor.html","title":"Get Class Prop. Descriptor","lang":"en-GB","frontmatter":{"title":"Get Class Prop. Descriptor","description":"Get property descriptor of target class property.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/getClassPropertyDescriptor.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/getClassPropertyDescriptors.html.d746e1f4.js b/assets/js/getClassPropertyDescriptors.html.d746e1f4.js
new file mode 100644
index 00000000..8102d1b6
--- /dev/null
+++ b/assets/js/getClassPropertyDescriptors.html.d746e1f4.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9443],{9595:function(n,s,a){a.r(s),a.d(s,{comp:function(){return u},data:function(){return d}});var t=a(641);const e={id:"getclasspropertydescriptors",tabindex:"-1"},p={class:"header-anchor",href:"#getclasspropertydescriptors"},o=(0,t.Lk)("code",null,"getClassPropertyDescriptors",-1),c={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/getOwnPropertyDescriptor",target:"_blank",rel:"noopener noreferrer"},l=(0,t.Lk)("code",null,"descriptors",-1),i=(0,t.Fv)('
It accepts the following arguments:
target: ConstructorOrAbstractConstructor - The target class.
recursive: boolean = false - (optional) If true, then target's parent prototypes are traversed. Descriptors are merged, such that the top-most class' descriptors are returned.
getClassPropertyDescriptors() throws TypeError if target does not have a prototype property.
',6),r={};var u=(0,a(6262).A)(r,[["render",function(n,s){const a=(0,t.g2)("Badge"),r=(0,t.g2)("ExternalLinkIcon");return(0,t.uX)(),(0,t.CE)("div",null,[(0,t.Lk)("h1",e,[(0,t.Lk)("a",p,[(0,t.Lk)("span",null,[o,(0,t.eW)(),(0,t.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,t.Lk)("p",null,[(0,t.eW)("Returns all property "),(0,t.Lk)("a",c,[l,(0,t.bF)(r)]),(0,t.eW)(" that are defined target's prototype.")]),i])}]]);const d=JSON.parse('{"path":"/archive/current/packages/support/reflections/getClassPropertyDescriptors.html","title":"Get Class Prop. Descriptors","lang":"en-GB","frontmatter":{"title":"Get Class Prop. Descriptors","description":"Get all property descriptors of target class.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/getClassPropertyDescriptors.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/getConstructorName.html.71e9279b.js b/assets/js/getConstructorName.html.71e9279b.js
new file mode 100644
index 00000000..5e05a149
--- /dev/null
+++ b/assets/js/getConstructorName.html.71e9279b.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9583],{3252:function(n,s,a){a.r(s),a.d(s,{comp:function(){return l},data:function(){return i}});var t=a(641);const e={id:"getconstructorname",tabindex:"-1"},o={class:"header-anchor",href:"#getconstructorname"},c=(0,t.Lk)("code",null,"getConstructorName",-1),p=(0,t.Fv)('
Returns target class' constructor name, if available.
It accepts the following arguments:
target: ConstructorOrAbstractConstructor - The target class
defaultValue: string|null = null - (optional) A default string value to return if target has no constructor name.
',4),r={};var l=(0,a(6262).A)(r,[["render",function(n,s){const a=(0,t.g2)("Badge");return(0,t.uX)(),(0,t.CE)("div",null,[(0,t.Lk)("h1",e,[(0,t.Lk)("a",o,[(0,t.Lk)("span",null,[c,(0,t.eW)(),(0,t.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),p])}]]);const i=JSON.parse('{"path":"/archive/current/packages/support/reflections/getConstructorName.html","title":"Get Constructor Name","lang":"en-GB","frontmatter":{"title":"Get Constructor Name","description":"Get name of target class\' constructor","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/getConstructorName.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/getErrorMessage.html.4590141f.js b/assets/js/getErrorMessage.html.4590141f.js
new file mode 100644
index 00000000..540cea56
--- /dev/null
+++ b/assets/js/getErrorMessage.html.4590141f.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9127],{5312:function(n,s,a){a.r(s),a.d(s,{comp:function(){return l},data:function(){return u}});var e=a(641);const t=(0,e.Lk)("h1",{id:"geterrormessage",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#geterrormessage"},[(0,e.Lk)("span",null,[(0,e.Lk)("code",null,"getErrorMessage")])])],-1),o=(0,e.Lk)("code",null,"message",-1),p={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error",target:"_blank",rel:"noopener noreferrer"},r=(0,e.Lk)("code",null,"Error",-1),c=(0,e.Fv)('
import{ getErrorMessage }from"@aedart/support/exceptions";\n\ntry{\n thrownewError('Something went wrong!');\n}catch(e){\n const msg =getErrorMessage(e,'unknown error');// Something went wrong! \n}\n\n// ---------------------------------------------------------------------------\n\ntry{\n throw'Something went wrong!';\n}catch(e){\n const msg =getErrorMessage(e,'unknown error');// unknown error \n}\n
',1),i={};var l=(0,a(6262).A)(i,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Returns an Error's "),o,(0,e.eW)(", if an "),(0,e.Lk)("a",p,[r,(0,e.bF)(a)]),(0,e.eW)(" instance is provided. Otherwise, a default message is returned.")]),c])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/exceptions/getErrorMessage.html","title":"Get Error Message","lang":"en-GB","frontmatter":{"title":"Get Error Message","description":"Obtain error or default message.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/exceptions/getErrorMessage.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/getNameOrDesc.html.6c2642af.js b/assets/js/getNameOrDesc.html.6c2642af.js
new file mode 100644
index 00000000..67bccd38
--- /dev/null
+++ b/assets/js/getNameOrDesc.html.6c2642af.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[1705],{2075:function(a,n,s){s.r(n),s.d(n,{comp:function(){return r},data:function(){return l}});var e=s(641);const t={id:"getnameordesc",tabindex:"-1"},c={class:"header-anchor",href:"#getnameordesc"},o=(0,e.Lk)("code",null,"getNameOrDesc",-1),p=(0,e.Fv)('
',1),i={};var r=(0,s(6262).A)(i,[["render",function(a,n){const s=(0,e.g2)("Badge"),i=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",c,[(0,e.Lk)("span",null,[o,(0,e.eW)(),(0,e.bF)(s,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,e.Lk)("p",null,[(0,e.eW)("Returns target class' "),(0,e.bF)(i,{to:"/archive/current/packages/support/reflections/getConstructorName.html"},{default:(0,e.k6)((()=>[(0,e.eW)("constructor name")])),_:1}),(0,e.eW)(", or "),(0,e.bF)(i,{to:"/archive/current/packages/support/misc/descTag.html"},{default:(0,e.k6)((()=>[(0,e.eW)("description tag")])),_:1}),(0,e.eW)(" if name is not available.")]),p])}]]);const l=JSON.parse('{"path":"/archive/current/packages/support/reflections/getNameOrDesc.html","title":"Get Name Or Desc. Tag","lang":"en-GB","frontmatter":{"title":"Get Name Or Desc. Tag","description":"Get name of target class\' constructor, or description tag","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/getNameOrDesc.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/getParentOfClass.html.844074cb.js b/assets/js/getParentOfClass.html.844074cb.js
new file mode 100644
index 00000000..3f221605
--- /dev/null
+++ b/assets/js/getParentOfClass.html.844074cb.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[5067],{7836:function(s,n,a){a.r(n),a.d(n,{comp:function(){return r},data:function(){return u}});var e=a(641);const t={id:"getparentofclass",tabindex:"-1"},l={class:"header-anchor",href:"#getparentofclass"},p=(0,e.Lk)("code",null,"getParentOfClass",-1),c=(0,e.Fv)('
Returns the parent class of given target class, or null if class does not have a parent.
',2),o=(0,e.Lk)("code",null,"getAllParentsOfClass()",-1),i={};var r=(0,a(6262).A)(i,[["render",function(s,n){const a=(0,e.g2)("Badge"),i=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",l,[(0,e.Lk)("span",null,[p,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),c,(0,e.Lk)("p",null,[(0,e.Lk)("em",null,[(0,e.eW)("See also "),(0,e.bF)(i,{to:"/archive/current/packages/support/reflections/getAllParentsOfClass.html"},{default:(0,e.k6)((()=>[o])),_:1}),(0,e.eW)(".")])])])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/reflections/getParentOfClass.html","title":"Get Parent Of Class","lang":"en-GB","frontmatter":{"title":"Get Parent Of Class","description":"Get parent class.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/getParentOfClass.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/has.html.c6f27798.js b/assets/js/has.html.c6f27798.js
new file mode 100644
index 00000000..130670c2
--- /dev/null
+++ b/assets/js/has.html.c6f27798.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3246],{9586:function(n,s,a){a.r(s),a.d(s,{comp:function(){return i},data:function(){return u}});var e=a(641);const t=(0,e.Lk)("h1",{id:"has",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#has"},[(0,e.Lk)("span",null,[(0,e.Lk)("code",null,"has")])])],-1),p={href:"https://lodash.com/docs/4.17.15#hasIn",target:"_blank",rel:"noopener noreferrer"},o=(0,e.Lk)("code",null,"hasIn",-1),l=(0,e.Lk)("code",null,"isset()",-1),r=(0,e.Fv)('
import{ has }from"@aedart/support/objects";\n\nconst target ={\n a:1234,\n b:{\n c:{\n age:24\n }\n },\n};\n\nlet result =has(target,'b.c.age');\nconsole.log(result);// true\n
',1),c={};var i=(0,a(6262).A)(c,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon"),c=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Determine if path is a property of given object. "),(0,e.Lk)("em",null,[(0,e.eW)("Method is an alias for "),(0,e.Lk)("a",p,[(0,e.eW)("Lodash "),o,(0,e.bF)(a)]),(0,e.eW)(".")])]),(0,e.Lk)("p",null,[(0,e.Lk)("em",null,[(0,e.eW)("See also "),(0,e.bF)(c,{to:"/archive/current/packages/support/objects/isset.html"},{default:(0,e.k6)((()=>[l])),_:1}),(0,e.eW)(".")])]),r])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/objects/has.html","title":"Has","lang":"en-GB","frontmatter":{"title":"Has","description":"Determine if object path is a property.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/has.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/hasAll.html.51adf6fd.js b/assets/js/hasAll.html.51adf6fd.js
new file mode 100644
index 00000000..07dba59f
--- /dev/null
+++ b/assets/js/hasAll.html.51adf6fd.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[8423],{1747:function(n,s,a){a.r(s),a.d(s,{comp:function(){return i},data:function(){return r}});var t=a(641);const p=(0,t.Lk)("h1",{id:"hasall",tabindex:"-1"},[(0,t.Lk)("a",{class:"header-anchor",href:"#hasall"},[(0,t.Lk)("span",null,[(0,t.Lk)("code",null,"hasAll")])])],-1),e=(0,t.Lk)("p",null,"Determine if all paths are properties of given object.",-1),o=(0,t.Lk)("code",null,"isset()",-1),l=(0,t.Fv)('
',1),c={};var i=(0,a(6262).A)(c,[["render",function(n,s){const a=(0,t.g2)("RouteLink");return(0,t.uX)(),(0,t.CE)("div",null,[p,e,(0,t.Lk)("p",null,[(0,t.Lk)("em",null,[(0,t.eW)("See also "),(0,t.bF)(a,{to:"/archive/current/packages/support/objects/isset.html"},{default:(0,t.k6)((()=>[o])),_:1}),(0,t.eW)(".")])]),l])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/objects/hasAll.html","title":"Has All","lang":"en-GB","frontmatter":{"title":"Has All","description":"Determine if all object paths are properties.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/hasAll.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/hasAllMethods.html.194f3e31.js b/assets/js/hasAllMethods.html.194f3e31.js
new file mode 100644
index 00000000..21ee92b7
--- /dev/null
+++ b/assets/js/hasAllMethods.html.194f3e31.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[1901],{3184:function(n,s,a){a.r(s),a.d(s,{comp:function(){return i},data:function(){return r}});var t=a(641);const e={id:"hasallmethods",tabindex:"-1"},o={class:"header-anchor",href:"#hasallmethods"},p=(0,t.Lk)("code",null,"hasAllMethods",-1),c=(0,t.Fv)('
Determine if given target object contains all given methods.
It accepts the following arguments:
target: object - The target.
...methods: PropertyKey[] - Names of the methods to check for.
',4),l={};var i=(0,a(6262).A)(l,[["render",function(n,s){const a=(0,t.g2)("Badge");return(0,t.uX)(),(0,t.CE)("div",null,[(0,t.Lk)("h1",e,[(0,t.Lk)("a",o,[(0,t.Lk)("span",null,[p,(0,t.eW)(),(0,t.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),c])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/reflections/hasAllMethods.html","title":"Has All Methods","lang":"en-GB","frontmatter":{"title":"Has All Methods","description":"Determine if target has all methods","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/hasAllMethods.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/hasAny.html.a9e65a87.js b/assets/js/hasAny.html.a9e65a87.js
new file mode 100644
index 00000000..beb431b0
--- /dev/null
+++ b/assets/js/hasAny.html.a9e65a87.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9150],{4079:function(n,s,a){a.r(s),a.d(s,{comp:function(){return o},data:function(){return c}});var e=a(641);const t=[(0,e.Fv)('
Determine if any paths are properties of given object.
import{ hasAny }from"@aedart/support/objects";\n\nconst target ={\n a:1234,\n b:{\n name:'Sven',\n c:{\n age:24\n }\n }\n};\n\nconst paths =[\n 'z',// does not exist\n 'b.c.name',// does not exist\n 'b.c.age',// exist\n];\n\nlet result =hasAny(target, paths);\nconsole.log(result);// true\n
',3)],p={};var o=(0,a(6262).A)(p,[["render",function(n,s){return(0,e.uX)(),(0,e.CE)("div",null,t)}]]);const c=JSON.parse('{"path":"/archive/current/packages/support/objects/hasAny.html","title":"Has Any","lang":"en-GB","frontmatter":{"title":"Has Any","description":"Determine if any object paths are properties.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/hasAny.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/hasMethod.html.b8b97f0e.js b/assets/js/hasMethod.html.b8b97f0e.js
new file mode 100644
index 00000000..eb026f85
--- /dev/null
+++ b/assets/js/hasMethod.html.b8b97f0e.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[8483],{8869:function(n,a,s){s.r(a),s.d(a,{comp:function(){return l},data:function(){return u}});var t=s(641);const e={id:"hasmethod",tabindex:"-1"},o={class:"header-anchor",href:"#hasmethod"},p=(0,t.Lk)("code",null,"hasMethod",-1),c=(0,t.Fv)('
Determine if given target object contains method.
It accepts the following arguments:
target: object - The target.
method: PropertyKey - Name of the method to check for.
',4),i={};var l=(0,s(6262).A)(i,[["render",function(n,a){const s=(0,t.g2)("Badge");return(0,t.uX)(),(0,t.CE)("div",null,[(0,t.Lk)("h1",e,[(0,t.Lk)("a",o,[(0,t.Lk)("span",null,[p,(0,t.eW)(),(0,t.bF)(s,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),c])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/reflections/hasMethod.html","title":"Has Method","lang":"en-GB","frontmatter":{"title":"Has Method","description":"Determine if target has method","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/hasMethod.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/hasPrototypeProperty.html.f0d6526f.js b/assets/js/hasPrototypeProperty.html.f0d6526f.js
new file mode 100644
index 00000000..e91f9aa1
--- /dev/null
+++ b/assets/js/hasPrototypeProperty.html.f0d6526f.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3287],{6195:function(n,s,a){a.r(s),a.d(s,{comp:function(){return l},data:function(){return r}});var t=a(641);const p={id:"hasprototypeproperty",tabindex:"-1"},o={class:"header-anchor",href:"#hasprototypeproperty"},e=(0,t.Lk)("code",null,"hasPrototypeProperty",-1),c=(0,t.Fv)('
Determines if object has a prototype property defined and that it is not null or undefined.
',2),u={};var l=(0,a(6262).A)(u,[["render",function(n,s){const a=(0,t.g2)("Badge");return(0,t.uX)(),(0,t.CE)("div",null,[(0,t.Lk)("h1",p,[(0,t.Lk)("a",o,[(0,t.Lk)("span",null,[e,(0,t.eW)(),(0,t.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),c])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/reflections/hasPrototypeProperty.html","title":"Has Prototype Property","lang":"en-GB","frontmatter":{"title":"Has Prototype Property","description":"Determine if \\"prototype\\" property exists.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/hasPrototypeProperty.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/hasUniqueId.html.b9df194e.js b/assets/js/hasUniqueId.html.b9df194e.js
new file mode 100644
index 00000000..0f046b89
--- /dev/null
+++ b/assets/js/hasUniqueId.html.b9df194e.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[8852],{1862:function(n,a,s){s.r(a),s.d(a,{comp:function(){return r},data:function(){return d}});var e=s(641);const t={id:"hasuniqueid",tabindex:"-1"},i={class:"header-anchor",href:"#hasuniqueid"},p=(0,e.Lk)("code",null,"hasUniqueId",-1),o=(0,e.Lk)("p",null,"Determine if an object has a unique id.",-1),c=(0,e.Lk)("code",null,"uniqueId",-1),u=(0,e.Fv)('
',1),l={};var r=(0,s(6262).A)(l,[["render",function(n,a){const s=(0,e.g2)("Badge"),l=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",i,[(0,e.Lk)("span",null,[p,(0,e.eW)(),(0,e.bF)(s,{type:"tip",text:"Available since v0.6",vertical:"middle"})])])]),o,(0,e.Lk)("p",null,[(0,e.Lk)("em",null,[(0,e.eW)("See "),(0,e.bF)(l,{to:"/archive/current/packages/support/objects/uniqueId.html"},{default:(0,e.k6)((()=>[c])),_:1}),(0,e.eW)(" for additional details.")])]),u])}]]);const d=JSON.parse('{"path":"/archive/current/packages/support/objects/hasUniqueId.html","title":"Has Unique ID","lang":"en-GB","frontmatter":{"title":"Has Unique ID","description":"Determine if object has a unique id.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/hasUniqueId.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/hooks.html.a0da77d5.js b/assets/js/hooks.html.a0da77d5.js
new file mode 100644
index 00000000..edb4ea9e
--- /dev/null
+++ b/assets/js/hooks.html.a0da77d5.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[2822],{6940:function(n,s,a){a.r(s),a.d(s,{comp:function(){return r},data:function(){return l}});var t=a(641);const e=(0,t.Lk)("h1",{id:"hooks",tabindex:"-1"},[(0,t.Lk)("a",{class:"header-anchor",href:"#hooks"},[(0,t.Lk)("span",null,"Hooks")])],-1),o=(0,t.Lk)("p",null,"Concerns offer a few hook methods. These can be used to perform advanced setup or initialisation logic.",-1),p={class:"table-of-contents"},c=(0,t.Fv)('
To perform pre-registration logic, use the static BEFORE method in your concern class. This hook method is invoked before the concern container and aliases are defined in the target class.
The method accepts the following arguments:
target: UsesConcerns - the target class (class constructor!).
import{BEFORE}from"@aedart/contracts/support/concerns";\nimport{ AbstractConcern }from"@aedart/support/concerns";\nimport{ isSubclass }from'@aedart/support/reflections';\n\nimport{ JobHandler }from'@acme/jobs';\n\nclassRecordsJobsextendsAbstractConcern{\n \n static[BEFORE](target){\n // E.g. prevent this concern from being used by all kinds of targets...\n if(!isSubclass(target, JobHandler)){\n thrownewTypeError('RecordsJobs can only be used by JobHandler');\n }\n }\n}\n
To perform post-registration logic, use the static AFTER method in your concern class. This method is invoked after the concern container and aliases have been defined in target's prototype.
The method accepts the following arguments:
target: UsesConcerns - the target class (class constructor!).
import{AFTER}from"@aedart/contracts/support/concerns";\nimport{ AbstractConcern }from"@aedart/support/concerns";\n\nimport{ ApiConnection }from'@acme/api';\n\nclassRecordsJobsextendsAbstractConcern{\n \n static[AFTER](target){\n // E.g. init or setup static resources...\n ApiConnection.init();\n }\n}\n
',10),i={};var r=(0,a(6262).A)(i,[["render",function(n,s){const a=(0,t.g2)("router-link");return(0,t.uX)(),(0,t.CE)("div",null,[e,o,(0,t.Lk)("nav",p,[(0,t.Lk)("ul",null,[(0,t.Lk)("li",null,[(0,t.bF)(a,{to:"#before-registration"},{default:(0,t.k6)((()=>[(0,t.eW)("BEFORE Registration")])),_:1})]),(0,t.Lk)("li",null,[(0,t.bF)(a,{to:"#after-registration"},{default:(0,t.k6)((()=>[(0,t.eW)("AFTER Registration")])),_:1})])])]),c])}]]);const l=JSON.parse('{"path":"/archive/current/packages/support/concerns/hooks.html","title":"Hooks","lang":"en-GB","frontmatter":{"title":"Hooks","description":"How to use registration hooks","sidebarDepth":0},"headers":[{"level":2,"title":"BEFORE Registration","slug":"before-registration","link":"#before-registration","children":[]},{"level":2,"title":"AFTER Registration","slug":"after-registration","link":"#after-registration","children":[]}],"git":{"updatedTime":1709641376000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/concerns/hooks.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/includesAll.html.b83b88e2.js b/assets/js/includesAll.html.b83b88e2.js
new file mode 100644
index 00000000..61bd177c
--- /dev/null
+++ b/assets/js/includesAll.html.b83b88e2.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[4610],{5567:function(n,a,s){s.r(a),s.d(a,{comp:function(){return c},data:function(){return l}});var t=s(641);const e=[(0,t.Fv)('
',3)],p={};var c=(0,a(6262).A)(p,[["render",function(n,s){return(0,e.uX)(),(0,e.CE)("div",null,t)}]]);const o=JSON.parse('{"path":"/archive/current/packages/support/arrays/includesAny.html","title":"Includes Any","lang":"en-GB","frontmatter":{"title":"Includes Any","description":"Determine if array contains some values.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/arrays/includesAny.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/index.html.5b4548ed.js b/assets/js/index.html.5b4548ed.js
new file mode 100644
index 00000000..caa4db65
--- /dev/null
+++ b/assets/js/index.html.5b4548ed.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[4470],{406:function(n,a,e){e.r(a),e.d(a,{comp:function(){return N},data:function(){return O}});var s=e(641);const t=(0,s.Lk)("h1",{id:"release-notes",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#release-notes"},[(0,s.Lk)("span",null,"Release Notes")])],-1),i={class:"custom-container danger"},o=(0,s.Lk)("p",{class:"custom-container-title"},"DANGER",-1),l=(0,s.Lk)("p",null,[(0,s.eW)("Ion is still in development. You "),(0,s.Lk)("em",null,"SHOULD NOT"),(0,s.eW)(" use any of the packages in a production environment. Breaking changes "),(0,s.Lk)("em",null,[(0,s.Lk)("strong",null,"MUST")]),(0,s.eW)(" be expected for all "),(0,s.Lk)("code",null,"v0.x"),(0,s.eW)(" releases!")],-1),c={href:"https://github.com/aedart/ion/blob/main/CHANGELOG.md",target:"_blank",rel:"noopener noreferrer"},p=(0,s.Lk)("code",null,"CHANGELOG.md",-1),r={class:"table-of-contents"},u=(0,s.Fv)('
import{ use, AbstractConcern }from"@aedart/support/concerns";\n\n// A concern class...\nclassRoleextendsAbstractConcern{\n addRole(name){\n /* ...not shown... */\n }\n}\n\n// Use concern in target class...\n@use(Role)\nclassUser{}\n\n// Later in your application...\nconst user =newUser();\nuser.addRole('maintainer');\nuser.addRole('supporter');\n
import{targetMeta, getTargetMeta}from'@aedart/support/meta';\n\nclassService{\n\n @targetMeta('desc','Seaches for cities')\n search(){\n // ...not shown...\n }\n}\n\nconst instance =newService();\n\n// ...later in your application...\ngetTargetMeta(instance.search,'desc');// Seaches for cities\n
import{meta, getMeta}from'@aedart/support/meta';\n\n@meta('description','Able to search for locations')\nclassService{}\n\ngetMeta(Service,'description');// Able to search for locations\n
',1),j={id:"support",tabindex:"-1"},R={class:"header-anchor",href:"#support"},S={id:"vuepress-utils",tabindex:"-1"},_={class:"header-anchor",href:"#vuepress-utils"},U=(0,s.Lk)("code",null,"Archive",-1),H={};var N=(0,e(6262).A)(H,[["render",function(n,a){const e=(0,s.g2)("ExternalLinkIcon"),H=(0,s.g2)("router-link"),N=(0,s.g2)("Badge"),O=(0,s.g2)("RouteLink");return(0,s.uX)(),(0,s.CE)("div",null,[t,(0,s.Lk)("div",i,[o,l,(0,s.Lk)("p",null,[(0,s.Lk)("em",null,[(0,s.eW)("Please review the "),(0,s.Lk)("a",c,[p,(0,s.bF)(e)]),(0,s.eW)(" for additional details.")])])]),(0,s.Lk)("nav",r,[(0,s.Lk)("ul",null,[(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#support-policy"},{default:(0,s.k6)((()=>[(0,s.eW)("Support Policy")])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#v0-x-highlights"},{default:(0,s.k6)((()=>[(0,s.eW)("v0.x Highlights")])),_:1}),(0,s.Lk)("ul",null,[(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#concerns"},{default:(0,s.k6)((()=>[(0,s.eW)("Concerns "),(0,s.bF)(N,{type:"tip",text:"Available since v0.9"})])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#merge"},{default:(0,s.k6)((()=>[(0,s.eW)("Merge "),(0,s.bF)(N,{type:"tip",text:"Available since v0.9"})])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#mixins"},{default:(0,s.k6)((()=>[(0,s.eW)("Mixins "),(0,s.bF)(N,{type:"tip",text:"Available since v0.8"})])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#target-meta-decorator"},{default:(0,s.k6)((()=>[(0,s.eW)('"Target" Meta Decorator '),(0,s.bF)(N,{type:"tip",text:"Available since v0.7"})])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#meta-decorator"},{default:(0,s.k6)((()=>[(0,s.eW)("Meta Decorator "),(0,s.bF)(N,{type:"tip",text:"Available since v0.6"})])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#support"},{default:(0,s.k6)((()=>[(0,s.eW)("Support "),(0,s.bF)(N,{type:"tip",text:"Available since v0.3"})])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(H,{to:"#vuepress-utils"},{default:(0,s.k6)((()=>[(0,s.eW)("Vuepress Utils "),(0,s.bF)(N,{type:"tip",text:"Available since v0.1"})])),_:1})])])])])]),u,(0,s.Lk)("h3",d,[(0,s.Lk)("a",k,[(0,s.Lk)("span",null,[(0,s.eW)("Concerns "),(0,s.bF)(N,{type:"tip",text:"Available since v0.9"})])])]),(0,s.Lk)("p",null,[(0,s.eW)("Intended as an alternative to mixins, the "),(0,s.bF)(O,{to:"/archive/current/packages/support/concerns/"},{default:(0,s.k6)((()=>[(0,s.eW)("Concerns")])),_:1}),(0,s.eW)(" submodule offers a different way to overcome some of the limitations of single inheritance.")]),m,(0,s.Lk)("h3",v,[(0,s.Lk)("a",h,[(0,s.Lk)("span",null,[(0,s.eW)("Merge "),(0,s.bF)(N,{type:"tip",text:"Available since v0.9"})])])]),(0,s.Lk)("p",null,[(0,s.eW)("Objects "),(0,s.bF)(O,{to:"/archive/current/packages/support/objects/merge.html"},{default:(0,s.k6)((()=>[(0,s.eW)("merge")])),_:1}),(0,s.eW)(" utility, using "),(0,s.Lk)("a",b,[(0,s.eW)("deep copy"),(0,s.bF)(e)]),(0,s.eW)(".")]),g,(0,s.Lk)("h3",f,[(0,s.Lk)("a",y,[(0,s.Lk)("span",null,[(0,s.eW)("Mixins "),(0,s.bF)(N,{type:"tip",text:"Available since v0.8"})])])]),(0,s.Lk)("p",null,[(0,s.eW)("Adaptation of Justin Fagnani's "),(0,s.Lk)("a",L,[x,(0,s.bF)(e)]),(0,s.eW)(".")]),A,(0,s.Lk)("p",null,[(0,s.eW)("See details and more examples in the "),(0,s.bF)(O,{to:"/archive/current/packages/support/mixins/"},{default:(0,s.k6)((()=>[W,(0,s.eW)(" documentation")])),_:1}),(0,s.eW)(".")]),(0,s.Lk)("h3",w,[(0,s.Lk)("a",F,[(0,s.Lk)("span",null,[(0,s.eW)('"Target" Meta Decorator '),(0,s.bF)(N,{type:"tip",text:"Available since v0.7"})])])]),(0,s.Lk)("p",null,[(0,s.eW)("Associate arbitrary metadata directly with the target element that is being decorated. "),(0,s.Lk)("em",null,[(0,s.eW)("See "),(0,s.bF)(O,{to:"/archive/current/packages/support/meta/targetMeta.html"},{default:(0,s.k6)((()=>[(0,s.eW)("target meta decorator")])),_:1}),(0,s.eW)(" fro additional details.")])]),M,(0,s.Lk)("h3",D,[(0,s.Lk)("a",E,[(0,s.Lk)("span",null,[(0,s.eW)("Meta Decorator "),(0,s.bF)(N,{type:"tip",text:"Available since v0.6"})])])]),(0,s.Lk)("p",null,[(0,s.eW)("The "),(0,s.bF)(O,{to:"/archive/current/packages/support/meta/"},{default:(0,s.k6)((()=>[(0,s.eW)("meta decorator")])),_:1}),(0,s.eW)(" is able to associate arbitrary metadata with a class and its elements.")]),Z,(0,s.Lk)("h3",j,[(0,s.Lk)("a",R,[(0,s.Lk)("span",null,[(0,s.eW)("Support "),(0,s.bF)(N,{type:"tip",text:"Available since v0.3"})])])]),(0,s.Lk)("p",null,[(0,s.eW)("A package intended to contain various helpers and utilities. At the moment, the package comes with a few "),(0,s.bF)(O,{to:"/archive/current/packages/support/objects/"},{default:(0,s.k6)((()=>[(0,s.eW)("object utilities")])),_:1}),(0,s.eW)(". See "),(0,s.bF)(O,{to:"/archive/current/packages/support/"},{default:(0,s.k6)((()=>[(0,s.eW)("package documentation")])),_:1}),(0,s.eW)(" for more details.")]),(0,s.Lk)("h3",S,[(0,s.Lk)("a",_,[(0,s.Lk)("span",null,[(0,s.eW)("Vuepress Utils "),(0,s.bF)(N,{type:"tip",text:"Available since v0.1"})])])]),(0,s.Lk)("p",null,[(0,s.eW)("Utilities for vuepress sites, which includes an "),U,(0,s.eW)(" component for structuring documentation into an archive. See "),(0,s.bF)(O,{to:"/archive/current/packages/vuepress-utils/"},{default:(0,s.k6)((()=>[(0,s.eW)("package documentation")])),_:1}),(0,s.eW)(" for details.")])])}]]);const O=JSON.parse('{"path":"/archive/current/","title":"Release Notes","lang":"en-GB","frontmatter":{"title":"Release Notes","description":"Ion Release Notes","sidebarDepth":0},"headers":[{"level":2,"title":"Support Policy","slug":"support-policy","link":"#support-policy","children":[]},{"level":2,"title":"v0.x Highlights","slug":"v0-x-highlights","link":"#v0-x-highlights","children":[{"level":3,"title":"Concerns","slug":"concerns","link":"#concerns","children":[]},{"level":3,"title":"Merge","slug":"merge","link":"#merge","children":[]},{"level":3,"title":"Mixins","slug":"mixins","link":"#mixins","children":[]},{"level":3,"title":"\\"Target\\" Meta Decorator","slug":"target-meta-decorator","link":"#target-meta-decorator","children":[]},{"level":3,"title":"Meta Decorator","slug":"meta-decorator","link":"#meta-decorator","children":[]},{"level":3,"title":"Support","slug":"support","link":"#support","children":[]},{"level":3,"title":"Vuepress Utils","slug":"vuepress-utils","link":"#vuepress-utils","children":[]}]}],"git":{"updatedTime":1709647602000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":9},{"name":"alin","email":"alin@rspsystems.com","commits":6}]},"filePathRelative":"archive/current/README.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},8272:function(n,a,e){e.r(a),e.d(a,{comp:function(){return p},data:function(){return r}});var s=e(641);const t={id:"introduction",tabindex:"-1"},i={class:"header-anchor",href:"#introduction"},o=(0,s.Lk)("p",null,"The contracts package contains types, interfaces and unique identifiers.",-1),l=(0,s.Lk)("p",null,[(0,s.Lk)("em",null,"More information available at a later point...")],-1),c={};var p=(0,e(6262).A)(c,[["render",function(n,a){const e=(0,s.g2)("Badge");return(0,s.uX)(),(0,s.CE)("div",null,[(0,s.Lk)("h1",t,[(0,s.Lk)("a",i,[(0,s.Lk)("span",null,[(0,s.eW)("Introduction "),(0,s.bF)(e,{type:"tip",text:"Available since v0.3",vertical:"middle"}),(0,s.bF)(e,{type:"success",text:"Browser",vertical:"middle"})])])]),o,l])}]]);const r=JSON.parse('{"path":"/archive/current/packages/contracts/","title":"Introduction","lang":"en-GB","frontmatter":{"title":"Introduction","description":"Ion Support package","sidebarDepth":0},"headers":[],"git":{"updatedTime":1680807921000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/packages/contracts/README.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},7957:function(n,a,e){e.r(a),e.d(a,{comp:function(){return b},data:function(){return g}});var s=e(641);const t=(0,s.Lk)("h1",{id:"packages",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#packages"},[(0,s.Lk)("span",null,"Packages")])],-1),i=(0,s.Lk)("p",null,"In here, you will find documentation for the available packages. A few things that might be good to know:",-1),o={class:"table-of-contents"},l=(0,s.Lk)("h2",{id:"environment",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#environment"},[(0,s.Lk)("span",null,"Environment")])],-1),c=(0,s.Lk)("p",null,[(0,s.Lk)("em",null,"You are of course welcome to use a package in a different environment than its original intent, if it is possible.")],-1),p=(0,s.Lk)("h2",{id:"available-since",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#available-since"},[(0,s.Lk)("span",null,"Available Since")])],-1),r=(0,s.Lk)("em",null,"available since x.y.z",-1),u=(0,s.Lk)("em",null,"or feature",-1),d=(0,s.Lk)("h2",{id:"not-released",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#not-released"},[(0,s.Lk)("span",null,"Not Released")])],-1),k=(0,s.Lk)("strong",null,"not yet been released",-1),m=(0,s.Lk)("h2",{id:"not-published",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#not-published"},[(0,s.Lk)("span",null,"Not Published")])],-1),v=(0,s.Lk)("em",null,"if documentation is made available about the package!",-1),h={};var b=(0,e(6262).A)(h,[["render",function(n,a){const e=(0,s.g2)("router-link"),h=(0,s.g2)("Badge"),b=(0,s.g2)("RouteLink");return(0,s.uX)(),(0,s.CE)("div",null,[t,i,(0,s.Lk)("nav",o,[(0,s.Lk)("ul",null,[(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#environment"},{default:(0,s.k6)((()=>[(0,s.eW)("Environment")])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#available-since"},{default:(0,s.k6)((()=>[(0,s.eW)("Available Since")])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#not-released"},{default:(0,s.k6)((()=>[(0,s.eW)("Not Released")])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#not-published"},{default:(0,s.k6)((()=>[(0,s.eW)("Not Published")])),_:1})])])]),l,(0,s.Lk)("p",null,[(0,s.eW)("Badges are used to indicate the environment that a package is intended for, e.g. "),(0,s.bF)(h,{type:"success",text:"Node",vertical:"middle"}),(0,s.bF)(h,{type:"success",text:"Browser",vertical:"middle"}),(0,s.eW)(".")]),c,p,(0,s.Lk)("p",null,[(0,s.eW)('The "'),r,(0,s.eW)('" badge might also be displayed, if a package '),u,(0,s.eW)(" was released during a minor version. E.g. "),(0,s.bF)(h,{type:"tip",text:"Available since v1.5",vertical:"middle"}),(0,s.eW)(".")]),d,(0,s.Lk)("p",null,[(0,s.eW)("Sometimes, documentation might be available for a package that has "),k,(0,s.eW)(". Usually it is tagged with a "),(0,s.bF)(h,{type:"warning",text:"Not Released",vertical:"middle"}),(0,s.eW)(" badge, "),(0,s.Lk)("em",null,[(0,s.eW)("unless the package documentation is located in "),(0,s.bF)(b,{to:"/archive/next/"},{default:(0,s.k6)((()=>[(0,s.eW)('"next" release"')])),_:1}),(0,s.eW)(".")])]),m,(0,s.Lk)("p",null,[(0,s.eW)("In rare situations, a package might only exist in the mono-repository and not published to npm's registry. Such a package is either experimental or internal, which means that it might not ever be published. Usually, it will be tagged with "),(0,s.bF)(h,{type:"danger",text:"Internal (not published)",vertical:"middle"}),(0,s.bF)(h,{type:"danger",text:"Experimental",vertical:"middle"}),(0,s.eW)(", or similar badges, "),v])])}]]);const g=JSON.parse('{"path":"/archive/current/packages/","title":"Introduction","lang":"en-GB","frontmatter":{"title":"Introduction","description":"Ion Packages","sidebarDepth":0},"headers":[{"level":2,"title":"Environment","slug":"environment","link":"#environment","children":[]},{"level":2,"title":"Available Since","slug":"available-since","link":"#available-since","children":[]},{"level":2,"title":"Not Released","slug":"not-released","link":"#not-released","children":[]},{"level":2,"title":"Not Published","slug":"not-published","link":"#not-published","children":[]}],"git":{"updatedTime":1706895598000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":6}]},"filePathRelative":"archive/current/packages/README.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},2019:function(n,a,e){e.r(a),e.d(a,{comp:function(){return p},data:function(){return r}});var s=e(641);const t={id:"about-arrays",tabindex:"-1"},i={class:"header-anchor",href:"#about-arrays"},o=(0,s.Lk)("code",null,"@aedart/support/arrays",-1),l={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array",target:"_blank",rel:"noopener noreferrer"},c={};var p=(0,e(6262).A)(c,[["render",function(n,a){const e=(0,s.g2)("Badge"),c=(0,s.g2)("ExternalLinkIcon");return(0,s.uX)(),(0,s.CE)("div",null,[(0,s.Lk)("h1",t,[(0,s.Lk)("a",i,[(0,s.Lk)("span",null,[(0,s.eW)("About Arrays "),(0,s.bF)(e,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,s.Lk)("p",null,[o,(0,s.eW)(" contains "),(0,s.Lk)("a",l,[(0,s.eW)("array"),(0,s.bF)(c)]),(0,s.eW)(" related utilities.")])])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/arrays/","title":"About Arrays","lang":"en-GB","frontmatter":{"title":"About Arrays","description":"Array utilities."},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/arrays/README.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},990:function(n,a,e){e.r(a),e.d(a,{comp:function(){return k},data:function(){return m}});var s=e(641);const t={id:"about-concerns",tabindex:"-1"},i={class:"header-anchor",href:"#about-concerns"},o={href:"https://www.php.net/manual/en/language.oop5.traits.php",target:"_blank",rel:"noopener noreferrer"},l={href:"https://javascript.info/mixins",target:"_blank",rel:"noopener noreferrer"},c={href:"https://en.wikipedia.org/wiki/Dependency_injection",target:"_blank",rel:"noopener noreferrer"},p=(0,s.Lk)("code",null,"@aedart/support/concerns",-1),r={href:"https://en.wikipedia.org/wiki/Inheritance_(object-oriented_programming)#Types",target:"_blank",rel:"noopener noreferrer"},u=(0,s.Fv)('
In this context, a "concern" is a class that can be injected into a target class, by means of the use() class decorator. The public properties and methods of the concern class are then "aliased" into the target class' prototype. In other words, "proxy" properties and methods are defined in the target class. They forward any interaction to the original properties and methods in the concern class instance.
import{ use, AbstractConcern }from"@aedart/support/concerns";\n\n// A concern class...\nclassConsolePrinterextendsAbstractConcern{\n print(message){\n console.log(message);\n }\n}\n\n// Taget class that uses a concern...\n@use(ConsolePrinter)\nclassPerson{\n \n sayHi(name){\n // Call method in concern\n this.print(`Hi ${name}`);\n }\n}\n\n// Later in your application...\nconst person =newPerson();\nperson.sayHi('Atrid');// Hi Astrid\n\nperson.print('Ho ho ho...');// Ho ho ho...\n
',3),d={};var k=(0,e(6262).A)(d,[["render",function(n,a){const e=(0,s.g2)("Badge"),d=(0,s.g2)("ExternalLinkIcon"),k=(0,s.g2)("RouteLink");return(0,s.uX)(),(0,s.CE)("div",null,[(0,s.Lk)("h1",t,[(0,s.Lk)("a",i,[(0,s.Lk)("span",null,[(0,s.eW)("About Concerns "),(0,s.bF)(e,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,s.Lk)("p",null,[(0,s.eW)("Inspired by PHP's "),(0,s.Lk)("a",o,[(0,s.eW)("Traits"),(0,s.bF)(d)]),(0,s.eW)(", traditional "),(0,s.Lk)("a",l,[(0,s.eW)("mixins"),(0,s.bF)(d)]),(0,s.eW)(", and a few concepts from "),(0,s.Lk)("a",c,[(0,s.eW)("dependency injection"),(0,s.bF)(d)]),(0,s.eW)(", the "),p,(0,s.eW)(" submodule offers an alternative approach to reducing some of the limitations of "),(0,s.Lk)("a",r,[(0,s.eW)("single inheritance"),(0,s.bF)(d)]),(0,s.eW)(".")]),u,(0,s.Lk)("p",null,[(0,s.eW)("See also "),(0,s.bF)(k,{to:"/archive/current/packages/support/mixins/"},{default:(0,s.k6)((()=>[(0,s.eW)('"Real" mixins')])),_:1}),(0,s.eW)(" as an alternative.")])])}]]);const m=JSON.parse('{"path":"/archive/current/packages/support/concerns/","title":"About Concerns","lang":"en-GB","frontmatter":{"title":"About Concerns","description":"Alternative mixin utility.","sidebarDepth":0},"headers":[{"level":2,"title":"Example","slug":"example","link":"#example","children":[]}],"git":{"updatedTime":1709647122000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":2}]},"filePathRelative":"archive/current/packages/support/concerns/README.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},4535:function(n,a,e){e.r(a),e.d(a,{comp:function(){return p},data:function(){return r}});var s=e(641);const t={id:"exceptions",tabindex:"-1"},i={class:"header-anchor",href:"#exceptions"},o=(0,s.Lk)("code",null,"@aedart/support/exceptions",-1),l={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error#custom_error_types",target:"_blank",rel:"noopener noreferrer"},c={};var p=(0,e(6262).A)(c,[["render",function(n,a){const e=(0,s.g2)("Badge"),c=(0,s.g2)("ExternalLinkIcon");return(0,s.uX)(),(0,s.CE)("div",null,[(0,s.Lk)("h1",t,[(0,s.Lk)("a",i,[(0,s.Lk)("span",null,[(0,s.eW)("Exceptions "),(0,s.bF)(e,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,s.Lk)("p",null,[o,(0,s.eW)(" offers a few utilities for working with "),(0,s.Lk)("a",l,[(0,s.eW)("Custom Errors"),(0,s.bF)(c)]),(0,s.eW)(".")])])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/exceptions/","title":"About Exceptions","lang":"en-GB","frontmatter":{"title":"About Exceptions","description":"Error & Exceptions utilities."},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/exceptions/README.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},9046:function(n,a,e){e.r(a),e.d(a,{comp:function(){return c},data:function(){return p}});var s=e(641);const t={id:"introduction",tabindex:"-1"},i={class:"header-anchor",href:"#introduction"},o=(0,s.Lk)("p",null,"The support package offers various utilities.",-1),l={};var c=(0,e(6262).A)(l,[["render",function(n,a){const e=(0,s.g2)("Badge");return(0,s.uX)(),(0,s.CE)("div",null,[(0,s.Lk)("h1",t,[(0,s.Lk)("a",i,[(0,s.Lk)("span",null,[(0,s.eW)("Introduction "),(0,s.bF)(e,{type:"tip",text:"Available since v0.3",vertical:"middle"}),(0,s.bF)(e,{type:"success",text:"Browser",vertical:"middle"})])])]),o])}]]);const p=JSON.parse('{"path":"/archive/current/packages/support/","title":"Introduction","lang":"en-GB","frontmatter":{"title":"Introduction","description":"Ion Support package","sidebarDepth":0},"headers":[],"git":{"updatedTime":1680807324000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/packages/support/README.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},332:function(n,a,e){e.r(a),e.d(a,{comp:function(){return c},data:function(){return p}});var s=e(641);const t={id:"about-meta",tabindex:"-1"},i={class:"header-anchor",href:"#about-meta"},o=(0,s.Fv)('
Provides a decorator that is able to associate metadata with a class, its methods and properties.
You can also overwrite the inherited metadata. The subclass that defines the metadata creates its own copy of the inherited metadata. The parent class' metadata remains untouched.
import{ meta, getMeta }from'@aedart/support/meta';\n\nclassService{\n \n @meta('search.desc','Searches for countries')\n search(){\n // ...not shown...\n }\n}\n\nclassCitySearcherextendsService{\n\n @meta('search.desc','Searches for cities')\n search(){\n // ...not shown...\n }\n}\n\nconst service =newCitySearcher();\n\ngetMeta(CitySearcher,'search.desc');// Searches for cities\ngetMeta(Service,'search.desc');// Searches for countries\n
',7)],l={};var p=(0,e(6262).A)(l,[["render",function(a,n){return(0,s.uX)(),(0,s.CE)("div",null,t)}]]);const r=JSON.parse('{"path":"/archive/current/packages/contracts/install.html","title":"How to install","lang":"en-GB","frontmatter":{"description":"How to install Ion Contracts package","sidebarDepth":0},"headers":[{"level":2,"title":"npm","slug":"npm","link":"#npm","children":[]},{"level":2,"title":"yarn","slug":"yarn","link":"#yarn","children":[]},{"level":2,"title":"pnpm","slug":"pnpm","link":"#pnpm","children":[]}],"git":{"updatedTime":1680807921000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/packages/contracts/install.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},492:function(a,n,e){e.r(n),e.d(n,{comp:function(){return p},data:function(){return r}});var s=e(641);const t=[(0,s.Fv)('
',7)],l={};var p=(0,e(6262).A)(l,[["render",function(a,n){return(0,s.uX)(),(0,s.CE)("div",null,t)}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/install.html","title":"How to install","lang":"en-GB","frontmatter":{"description":"How to install Ion Support package","sidebarDepth":0},"headers":[{"level":2,"title":"npm","slug":"npm","link":"#npm","children":[]},{"level":2,"title":"yarn","slug":"yarn","link":"#yarn","children":[]},{"level":2,"title":"pnpm","slug":"pnpm","link":"#pnpm","children":[]}],"git":{"updatedTime":1680807324000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/packages/support/install.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},5335:function(a,n,e){e.r(n),e.d(n,{comp:function(){return p},data:function(){return r}});var s=e(641);const t=[(0,s.Fv)('
',7)],l={};var p=(0,e(6262).A)(l,[["render",function(a,n){return(0,s.uX)(),(0,s.CE)("div",null,t)}]]);const r=JSON.parse('{"path":"/archive/current/packages/vuepress-utils/install.html","title":"How to install","lang":"en-GB","frontmatter":{"description":"How to install Vuepress Utils","sidebarDepth":0},"headers":[{"level":2,"title":"npm","slug":"npm","link":"#npm","children":[]},{"level":2,"title":"yarn","slug":"yarn","link":"#yarn","children":[]},{"level":2,"title":"pnpm","slug":"pnpm","link":"#pnpm","children":[]}],"git":{"updatedTime":1706259575000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":3},{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/vuepress-utils/install.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/instanceof.html.305d63a2.js b/assets/js/instanceof.html.305d63a2.js
new file mode 100644
index 00000000..81a538d3
--- /dev/null
+++ b/assets/js/instanceof.html.305d63a2.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[5646],{6192:function(n,s,a){a.r(s),a.d(s,{comp:function(){return l},data:function(){return u}});var e=a(641);const t=(0,e.Lk)("h1",{id:"instanceof-operator",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#instanceof-operator"},[(0,e.Lk)("span",null,[(0,e.Lk)("code",null,"instanceof"),(0,e.eW)(" Operator")])])],-1),p=(0,e.Lk)("code",null,"Mixin()",-1),o=(0,e.Lk)("code",null,"instanceof",-1),c=(0,e.Fv)('
',1),i={};var l=(0,a(6262).A)(i,[["render",function(n,s){const a=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("When you defined your mixins using the "),(0,e.bF)(a,{to:"/archive/current/packages/support/mixins/newMixin.html"},{default:(0,e.k6)((()=>[p,(0,e.eW)(" decorator function")])),_:1}),(0,e.eW)(", then it will support "),o,(0,e.eW)(" checks. Consider the following example:")]),c])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/mixins/instanceof.html","title":"Instanceof","lang":"en-GB","frontmatter":{"title":"Instanceof","description":"Using instanceof operator.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/mixins/instanceof.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isArrayLike.html.d228cb77.js b/assets/js/isArrayLike.html.d228cb77.js
new file mode 100644
index 00000000..009b85d1
--- /dev/null
+++ b/assets/js/isArrayLike.html.d228cb77.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[7044],{844:function(n,s,a){a.r(s),a.d(s,{comp:function(){return u},data:function(){return k}});var e=a(641);const t=(0,e.Lk)("h1",{id:"isarraylike",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#isarraylike"},[(0,e.Lk)("span",null,[(0,e.Lk)("code",null,"isArrayLike")])])],-1),p={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array#array-like_objects",target:"_blank",rel:"noopener noreferrer"},o=(0,e.Lk)("code",null,"isArrayLike()",-1),c={href:"https://lodash.com/docs/4.17.15#isArrayLike",target:"_blank",rel:"noopener noreferrer"},i=(0,e.Fv)('
',1),l=(0,e.Lk)("em",null,[(0,e.Lk)("code",null,"isSafeArrayLike()")],-1),r={};var u=(0,a(6262).A)(r,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon"),r=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Determines if a value is "),(0,e.Lk)("a",p,[(0,e.eW)('"array-like"'),(0,e.bF)(a)]),(0,e.eW)(".")]),(0,e.Lk)("p",null,[(0,e.eW)("("),(0,e.Lk)("em",null,[o,(0,e.eW)(" is an alias for Lodash's "),(0,e.Lk)("a",c,[(0,e.eW)("isArrayLike"),(0,e.bF)(a)]),(0,e.eW)(".")]),(0,e.eW)(")")]),i,(0,e.Lk)("p",null,[(0,e.eW)("See also "),(0,e.bF)(r,{to:"/archive/current/packages/support/arrays/issafearraylike.html"},{default:(0,e.k6)((()=>[l])),_:1}),(0,e.eW)(".")])])}]]);const k=JSON.parse('{"path":"/archive/current/packages/support/arrays/isArrayLike.html","title":"Is Array Like","lang":"en-GB","frontmatter":{"title":"Is Array Like","description":"Determine if value is array-like.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/arrays/isArrayLike.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isCloneable.html.29b12a95.js b/assets/js/isCloneable.html.29b12a95.js
new file mode 100644
index 00000000..b4b5509a
--- /dev/null
+++ b/assets/js/isCloneable.html.29b12a95.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6247],{2572:function(n,s,a){a.r(s),a.d(s,{comp:function(){return i},data:function(){return u}});var e=a(641);const t={id:"iscloneable",tabindex:"-1"},p={class:"header-anchor",href:"#iscloneable"},o=(0,e.Lk)("code",null,"isCloneable",-1),c=(0,e.Fv)('
Determines if given object is "cloneable". In this context "cloneable" means that an object implements the Cloneable interface, and offers a clone() method.
See @aedart/constracts/support/objects/Cloneable for details.
',3),l={};var i=(0,a(6262).A)(l,[["render",function(n,s){const a=(0,e.g2)("Badge");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[o,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),c])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/objects/isCloneable.html","title":"Is Cloneable","lang":"en-GB","frontmatter":{"title":"Is Cloneable","description":"Determine if object is cloneable.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/isCloneable.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isConcatSpreadable.html.af5da527.js b/assets/js/isConcatSpreadable.html.af5da527.js
new file mode 100644
index 00000000..7c6a9717
--- /dev/null
+++ b/assets/js/isConcatSpreadable.html.af5da527.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[7627],{4801:function(n,s,a){a.r(s),a.d(s,{comp:function(){return u},data:function(){return r}});var e=a(641);const t=(0,e.Lk)("h1",{id:"isconcatspreadable",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#isconcatspreadable"},[(0,e.Lk)("span",null,[(0,e.Lk)("code",null,"isConcatSpreadable")])])],-1),p={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol#well-known_symbols",target:"_blank",rel:"noopener noreferrer"},o={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/isConcatSpreadable",target:"_blank",rel:"noopener noreferrer"},c=(0,e.Lk)("code",null,"Symbol.isConcatSpreadable",-1),l=(0,e.Fv)('
import{ isConcatSpreadable }from'@aedart/support/arrays';\n\nisConcatSpreadable(null);// false\nisConcatSpreadable([1,2,3]);// false\nisConcatSpreadable({});// false\n\n// -------------------------------------------------------------------------\n\nconst arr =[1,2,3];\narr[Symbol.isConcatSpreadable]=true;\nisConcatSpreadable(arr);// true\n\n// -------------------------------------------------------------------------\n\nconst obj ={\n [Symbol.isConcatSpreadable]:true,\n\n // NOTE: length should be present, if Symbol.isConcatSpreadable\n // set to `true` However, isConcatSpreadable() does not check\n // if `length` is set!\n length:3,\n 0:'a',\n 1:'b',\n 2:'c'\n};\nisConcatSpreadable(obj);// true\n\n// ------------------------------------------------------------------------- \n\nclassA{}\nclassB{\n [Symbol.isConcatSpreadable]=false;\n}\nisConcatSpreadable(newA());// false\nisConcatSpreadable(newB());// true\n
',1),i={};var u=(0,a(6262).A)(i,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Determines if object contains the "),(0,e.Lk)("a",p,[(0,e.eW)("well-known"),(0,e.bF)(a)]),(0,e.eW)(" symbol "),(0,e.Lk)("a",o,[c,(0,e.bF)(a)]),(0,e.eW)(".")]),l])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/arrays/isConcatSpreadable.html","title":"Is Concat Spreadable","lang":"en-GB","frontmatter":{"title":"Is Concat Spreadable","description":"Determine if object is concat spreadable.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/arrays/isConcatSpreadable.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isConstructor.html.776fdd64.js b/assets/js/isConstructor.html.776fdd64.js
new file mode 100644
index 00000000..53f8c362
--- /dev/null
+++ b/assets/js/isConstructor.html.776fdd64.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[8874],{5843:function(n,s,a){a.r(s),a.d(s,{comp:function(){return k},data:function(){return d}});var t=a(641);const o=(0,t.Lk)("h1",{id:"isconstructor",tabindex:"-1"},[(0,t.Lk)("a",{class:"header-anchor",href:"#isconstructor"},[(0,t.Lk)("span",null,[(0,t.Lk)("code",null,"isConstructor")])])],-1),e={href:"https://github.com/caitp/TC39-Proposals/blob/trunk/tc39-reflect-isconstructor-iscallable.md",target:"_blank",rel:"noopener noreferrer"},c=(0,t.Lk)("code",null,"Function.isCallable() / Function.isConstructor()",-1),p=(0,t.Lk)("code",null,"isConstructor()",-1),i=(0,t.Fv)('
',2),u={href:"https://github.com/zloirock/core-js#function-iscallable-isconstructor-",target:"_blank",rel:"noopener noreferrer"},l=(0,t.Lk)("em",null,"License MIT",-1),r={};var k=(0,a(6262).A)(r,[["render",function(n,s){const a=(0,t.g2)("ExternalLinkIcon");return(0,t.uX)(),(0,t.CE)("div",null,[o,(0,t.Lk)("p",null,[(0,t.eW)("Based on the "),(0,t.Lk)("a",e,[(0,t.eW)("TC39 "),c,(0,t.bF)(a)]),(0,t.eW)(" proposal, the "),p,(0,t.eW)(" can determine if given argument is a constructor.")]),i,(0,t.Lk)("p",null,[(0,t.eW)("The source code of the above shown methods is heavily inspired by Denis Pushkarev's Core-js implementation of the "),(0,t.Lk)("a",u,[(0,t.eW)("Function.isCallable / Function.isConstructor"),(0,t.bF)(a)]),(0,t.eW)(" proposal ("),l,(0,t.eW)(").")])])}]]);const d=JSON.parse('{"path":"/archive/current/packages/support/reflections/isConstructor.html","title":"Is Constructor","lang":"en-GB","frontmatter":{"title":"Is Constructor","description":"Determine if value is a constructor.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/isConstructor.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isKey.html.e4b8f164.js b/assets/js/isKey.html.e4b8f164.js
new file mode 100644
index 00000000..63add13e
--- /dev/null
+++ b/assets/js/isKey.html.e4b8f164.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6529],{9845:function(n,s,a){a.r(s),a.d(s,{comp:function(){return l},data:function(){return u}});var t=a(641);const e={id:"iskey",tabindex:"-1"},p={class:"header-anchor",href:"#iskey"},o=(0,t.Lk)("code",null,"isKey",-1),c=(0,t.Fv)('
',1),i={};var l=(0,a(6262).A)(i,[["render",function(n,s){const a=(0,t.g2)("Badge"),i=(0,t.g2)("RouteLink");return(0,t.uX)(),(0,t.CE)("div",null,[(0,t.Lk)("h1",e,[(0,t.Lk)("a",p,[(0,t.Lk)("span",null,[o,(0,t.eW)(),(0,t.bF)(a,{type:"tip",text:"Available since v0.7",vertical:"middle"})])])]),(0,t.Lk)("p",null,[(0,t.eW)("Determine if given is a valid "),(0,t.bF)(i,{to:"/archive/current/packages/support/misc/isPropertyKey.html"},{default:(0,t.k6)((()=>[(0,t.eW)("key")])),_:1}),(0,t.eW)(" or "),(0,t.bF)(i,{to:"/archive/current/packages/support/objects/has.html"},{default:(0,t.k6)((()=>[(0,t.eW)("property path identifier")])),_:1}),(0,t.eW)(".")]),c])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/misc/isKey.html","title":"Is Key","lang":"en-GB","frontmatter":{"title":"Is Key","description":"Determine if is a key or path identifier","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/misc/isKey.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isKeySafe.html.bd9f806e.js b/assets/js/isKeySafe.html.bd9f806e.js
new file mode 100644
index 00000000..03934e81
--- /dev/null
+++ b/assets/js/isKeySafe.html.bd9f806e.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9088],{6536:function(n,s,a){a.r(s),a.d(s,{comp:function(){return r},data:function(){return u}});var e=a(641);const t={id:"iskeysafe",tabindex:"-1"},p={class:"header-anchor",href:"#iskeysafe"},i=(0,e.Lk)("code",null,"isKeySafe",-1),o=(0,e.Lk)("code",null,"isKeyUnsafe()",-1),c=(0,e.Fv)('
',1),l={};var r=(0,a(6262).A)(l,[["render",function(n,s){const a=(0,e.g2)("Badge"),l=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h2",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[i,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,e.Lk)("p",null,[(0,e.eW)("Opposite of "),(0,e.bF)(l,{to:"/archive/current/packages/support/reflections/isKeyUnsafe.html"},{default:(0,e.k6)((()=>[o])),_:1}),(0,e.eW)(".")]),c])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/reflections/isKeySafe.html","title":"Is Key Safe","lang":"en-GB","frontmatter":{"title":"Is Key Safe","description":"Determine if a property key is safe.","sidebarDepth":0},"headers":[{"level":2,"title":"isKeySafe","slug":"iskeysafe","link":"#iskeysafe","children":[]}],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/isKeySafe.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isKeyUnsafe.html.b2e04d30.js b/assets/js/isKeyUnsafe.html.b2e04d30.js
new file mode 100644
index 00000000..0da50d85
--- /dev/null
+++ b/assets/js/isKeyUnsafe.html.b2e04d30.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[4795],{715:function(s,n,a){a.r(n),a.d(n,{comp:function(){return l},data:function(){return r}});var e=a(641);const t={id:"iskeyunsafe",tabindex:"-1"},p={class:"header-anchor",href:"#iskeyunsafe"},i=(0,e.Lk)("code",null,"isKeyUnsafe",-1),o=(0,e.Fv)('
Determines if a property key is considered "unsafe".
Behind the scene, the isKeyUnsafe() function matches the given key against values from the predefined DANGEROUS_PROPERTIES list, which is defined in the @aedart/contracts/support/objects submodule;
',3),c={};var l=(0,a(6262).A)(c,[["render",function(s,n){const a=(0,e.g2)("Badge");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[i,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),o])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/reflections/isKeyUnsafe.html","title":"Is Key Unsafe","lang":"en-GB","frontmatter":{"title":"Is Key Unsafe","description":"Determine if a property key is unsafe.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":3}]},"filePathRelative":"archive/current/packages/support/reflections/isKeyUnsafe.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isPopulatable.html.f13a1d66.js b/assets/js/isPopulatable.html.f13a1d66.js
new file mode 100644
index 00000000..06956c1d
--- /dev/null
+++ b/assets/js/isPopulatable.html.f13a1d66.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6321],{6565:function(n,s,a){a.r(s),a.d(s,{comp:function(){return i},data:function(){return u}});var t=a(641);const e={id:"ispopulatable",tabindex:"-1"},p={class:"header-anchor",href:"#ispopulatable"},o=(0,t.Lk)("code",null,"isPopulatable",-1),c=(0,t.Fv)('
Determines if given object is "populatable". Here, "populatable" means that an object implements the Populatable interface, and offers a populate() method.
See @aedart/constracts/support/objects/Populatable for details.
',1),o={};var c=(0,a(6262).A)(o,[["render",function(n,s){const a=(0,t.g2)("ExternalLinkIcon");return(0,t.uX)(),(0,t.CE)("div",null,[e,(0,t.Lk)("p",null,[(0,t.eW)("Determine if a value is a "),(0,t.Lk)("a",p,[(0,t.eW)("primitive value"),(0,t.bF)(a)]),(0,t.eW)(".")]),i])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/misc/isPrimitive.html","title":"Is Primitive","lang":"en-GB","frontmatter":{"title":"Is Primitive","description":"Determine if value is a primitive.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/misc/isPrimitive.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isPropertyKey.html.16e05935.js b/assets/js/isPropertyKey.html.16e05935.js
new file mode 100644
index 00000000..6574c26c
--- /dev/null
+++ b/assets/js/isPropertyKey.html.16e05935.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[5394],{9937:function(n,s,a){a.r(s),a.d(s,{comp:function(){return l},data:function(){return u}});var t=a(641);const e={id:"ispropertykey",tabindex:"-1"},p={class:"header-anchor",href:"#ispropertykey"},o=(0,t.Lk)("code",null,"isPropertyKey",-1),c=(0,t.Fv)('
Determine if a key a valid property key name (string, number, or symbol).
',1),l={};var u=(0,s(6262).A)(l,[["render",function(n,a){const s=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)('Determines if value is "safe" '),p,(0,e.eW)(' object. In this context "safe" means that value is not a string, not an instance of '),(0,e.Lk)("a",o,[r,(0,e.bF)(s)]),(0,e.eW)(" object, and not a "),(0,e.Lk)("a",i,[(0,e.eW)("Typed Array"),(0,e.bF)(s)]),(0,e.eW)(" object.")]),c])}]]);const k=JSON.parse('{"path":"/archive/current/packages/support/arrays/isSafeArrayLike.html","title":"Is Safe Array Like","lang":"en-GB","frontmatter":{"title":"Is Safe Array Like","description":"Determine if value is \\"safe\\" array-like.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/arrays/isSafeArrayLike.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isSubclass.html.cec896be.js b/assets/js/isSubclass.html.cec896be.js
new file mode 100644
index 00000000..5aeec13e
--- /dev/null
+++ b/assets/js/isSubclass.html.cec896be.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3082],{2408:function(s,n,a){a.r(n),a.d(n,{comp:function(){return i},data:function(){return u}});var t=a(641);const e={id:"issubclass",tabindex:"-1"},c={class:"header-anchor",href:"#issubclass"},p=(0,t.Lk)("code",null,"isSubclass",-1),o=(0,t.Fv)('
Determine if target class is a subclass (child class) of given superclass (parent class).
It accepts the following arguments:
target: object - The target.
superclass: ConstructorOrAbstractConstructor - The superclass.
',4),l={};var i=(0,a(6262).A)(l,[["render",function(s,n){const a=(0,t.g2)("Badge");return(0,t.uX)(),(0,t.CE)("div",null,[(0,t.Lk)("h1",e,[(0,t.Lk)("a",c,[(0,t.Lk)("span",null,[p,(0,t.eW)(),(0,t.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),o])}]]);const u=JSON.parse('{"path":"/archive/current/packages/support/reflections/isSubclass.html","title":"Is Subclass","lang":"en-GB","frontmatter":{"title":"Is Subclass","description":"Determine if target is a subclass of another class.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/isSubclass.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isSubclassOrLooksLike.html.a105780a.js b/assets/js/isSubclassOrLooksLike.html.a105780a.js
new file mode 100644
index 00000000..08be66ad
--- /dev/null
+++ b/assets/js/isSubclassOrLooksLike.html.a105780a.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[4648],{5092:function(s,n,a){a.r(n),a.d(n,{comp:function(){return L},data:function(){return f}});var t=a(641);const e={id:"issubclassorlookslike",tabindex:"-1"},p={class:"header-anchor",href:"#issubclassorlookslike"},o=(0,t.Lk)("code",null,"isSubclassOrLooksLike",-1),l=(0,t.Lk)("p",null,"Determine if target class is a subclass of given superclass, or if it looks like given blueprint.",-1),c=(0,t.Lk)("p",null,"It accepts the following arguments:",-1),i=(0,t.Lk)("li",null,[(0,t.Lk)("code",null,"target: object"),(0,t.eW)(" - The target.")],-1),u=(0,t.Lk)("li",null,[(0,t.Lk)("code",null,"superclass: ConstructorOrAbstractConstructor"),(0,t.eW)(" - The superclass.")],-1),r=(0,t.Lk)("code",null,"blueprint: ClassBlueprint",-1),k=(0,t.Lk)("code",null,"classLooksLike",-1),d=(0,t.Fv)('
',1),m=(0,t.Lk)("code",null,"isSubclass()",-1),b=(0,t.Lk)("code",null,"classLooksLike()",-1),v={};var L=(0,a(6262).A)(v,[["render",function(s,n){const a=(0,t.g2)("Badge"),v=(0,t.g2)("RouteLink");return(0,t.uX)(),(0,t.CE)("div",null,[(0,t.Lk)("h1",e,[(0,t.Lk)("a",p,[(0,t.Lk)("span",null,[o,(0,t.eW)(),(0,t.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),l,c,(0,t.Lk)("ul",null,[i,u,(0,t.Lk)("li",null,[r,(0,t.eW)(" - Class Blueprint ("),(0,t.Lk)("em",null,[(0,t.eW)("See "),(0,t.bF)(v,{to:"/archive/current/packages/support/reflections/classLooksLike.html#class-blueprint"},{default:(0,t.k6)((()=>[k])),_:1})]),(0,t.eW)(").")])]),d,(0,t.Lk)("p",null,[(0,t.Lk)("em",null,[(0,t.eW)("See "),(0,t.bF)(v,{to:"/archive/current/packages/support/reflections/isSubclass.html"},{default:(0,t.k6)((()=>[m])),_:1}),(0,t.eW)(" and "),(0,t.bF)(v,{to:"/archive/current/packages/support/reflections/classLooksLike.html"},{default:(0,t.k6)((()=>[b])),_:1}),(0,t.eW)(" for additional details.")])])])}]]);const f=JSON.parse('{"path":"/archive/current/packages/support/reflections/isSubclassOrLooksLike.html","title":"Is Subclass Or Looks Like","lang":"en-GB","frontmatter":{"title":"Is Subclass Or Looks Like","description":"Determine if target is a subclass of another class, or looks like blueprint","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/isSubclassOrLooksLike.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isTypedArray.html.85c74ae6.js b/assets/js/isTypedArray.html.85c74ae6.js
new file mode 100644
index 00000000..b2c094cd
--- /dev/null
+++ b/assets/js/isTypedArray.html.85c74ae6.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6805],{7187:function(n,s,a){a.r(s),a.d(s,{comp:function(){return u},data:function(){return i}});var t=a(641);const p=(0,t.Lk)("h1",{id:"istypedarray",tabindex:"-1"},[(0,t.Lk)("a",{class:"header-anchor",href:"#istypedarray"},[(0,t.Lk)("span",null,[(0,t.Lk)("code",null,"isTypedArray")])])],-1),e={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray",target:"_blank",rel:"noopener noreferrer"},c=(0,t.Lk)("code",null,"TypedArray",-1),o=(0,t.Fv)('
',1),l={};var u=(0,a(6262).A)(l,[["render",function(n,s){const a=(0,t.g2)("ExternalLinkIcon");return(0,t.uX)(),(0,t.CE)("div",null,[p,(0,t.Lk)("p",null,[(0,t.eW)("Determines if target is an instance of a "),(0,t.Lk)("a",e,[c,(0,t.bF)(a)]),(0,t.eW)(".")]),o])}]]);const i=JSON.parse('{"path":"/archive/current/packages/support/arrays/isTypedArray.html","title":"Is Typed Array","lang":"en-GB","frontmatter":{"title":"Is Typed Array","description":"Determine if object is a typed array.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/arrays/isTypedArray.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isWeakKind.html.30eab0a8.js b/assets/js/isWeakKind.html.30eab0a8.js
new file mode 100644
index 00000000..b924e6f7
--- /dev/null
+++ b/assets/js/isWeakKind.html.30eab0a8.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9058],{6820:function(n,a,s){s.r(a),s.d(a,{comp:function(){return v},data:function(){return f}});var e=s(641);const t={id:"isweakkind",tabindex:"-1"},p={class:"header-anchor",href:"#isweakkind"},o=(0,e.Lk)("code",null,"isWeakKind",-1),c={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef",target:"_blank",rel:"noopener noreferrer"},i=(0,e.Lk)("code",null,"WeakRef",-1),l={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap",target:"_blank",rel:"noopener noreferrer"},u=(0,e.Lk)("code",null,"WeakMap",-1),k={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet",target:"_blank",rel:"noopener noreferrer"},r=(0,e.Lk)("code",null,"WeakSet",-1),d=(0,e.Fv)('
',1),m={};var v=(0,s(6262).A)(m,[["render",function(n,a){const s=(0,e.g2)("Badge"),m=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[o,(0,e.eW)(),(0,e.bF)(s,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,e.Lk)("p",null,[(0,e.eW)('Determine if object of a "weak" kind, e.g. '),(0,e.Lk)("a",c,[i,(0,e.bF)(m)]),(0,e.eW)(", "),(0,e.Lk)("a",l,[u,(0,e.bF)(m)]),(0,e.eW)(", or "),(0,e.Lk)("a",k,[r,(0,e.bF)(m)]),(0,e.eW)(".")]),d])}]]);const f=JSON.parse('{"path":"/archive/current/packages/support/reflections/isWeakKind.html","title":"Is WeakKind","lang":"en-GB","frontmatter":{"title":"Is WeakKind","description":"Determine if object is of a \\"weak\\" kind.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709548506000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/reflections/isWeakKind.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/isset.html.0803475b.js b/assets/js/isset.html.0803475b.js
new file mode 100644
index 00000000..ed3068ff
--- /dev/null
+++ b/assets/js/isset.html.0803475b.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9502],{8632:function(n,s,a){a.r(s),a.d(s,{comp:function(){return u},data:function(){return i}});var t=a(641);const e=(0,t.Lk)("h1",{id:"isset",tabindex:"-1"},[(0,t.Lk)("a",{class:"header-anchor",href:"#isset"},[(0,t.Lk)("span",null,[(0,t.Lk)("code",null,"isset")])])],-1),p=(0,t.Lk)("p",null,[(0,t.eW)("Determine if value is different from "),(0,t.Lk)("code",null,"undefined"),(0,t.eW)(" and "),(0,t.Lk)("code",null,"null"),(0,t.eW)(".")],-1),o=(0,t.Lk)("code",null,"empty()",-1),c=(0,t.Fv)('
',3),i={};var r=(0,a(6262).A)(i,[["render",function(n,s){const a=(0,t.g2)("RouteLink");return(0,t.uX)(),(0,t.CE)("div",null,[e,(0,t.Lk)("p",null,[(0,t.eW)("Determine if paths are properties of given object and have values. This method differs from "),(0,t.bF)(a,{to:"/archive/current/packages/support/objects/has.html"},{default:(0,t.k6)((()=>[p])),_:1}),(0,t.eW)(", in that it only returns true if properties' values are not "),o,(0,t.eW)(" and not "),c,(0,t.eW)(".")]),(0,t.Lk)("p",null,[(0,t.Lk)("em",null,[(0,t.eW)("See also "),(0,t.bF)(a,{to:"/archive/current/packages/support/misc/isset.html"},{default:(0,t.k6)((()=>[(0,t.eW)("misc. "),l])),_:1}),(0,t.eW)(".")])]),u])}]]);const k=JSON.parse('{"path":"/archive/current/packages/support/objects/isset.html","title":"Isset","lang":"en-GB","frontmatter":{"title":"Isset","description":"Determine if object object paths are set and have values.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/isset.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/jsdoc.html.fc513c7e.js b/assets/js/jsdoc.html.fc513c7e.js
new file mode 100644
index 00000000..43120683
--- /dev/null
+++ b/assets/js/jsdoc.html.fc513c7e.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6745],{7975:function(n,s,a){a.r(s),a.d(s,{comp:function(){return M},data:function(){return T}});var e=a(641);const t=(0,e.Lk)("h1",{id:"jsdoc",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#jsdoc"},[(0,e.Lk)("span",null,"JSDoc")])],-1),o={href:"https://jsdoc.app/",target:"_blank",rel:"noopener noreferrer"},p={class:"table-of-contents"},l={class:"custom-container tip"},c=(0,e.Lk)("p",{class:"custom-container-title"},"Help wanted!",-1),i=(0,e.Lk)("h2",{id:"mixin-and-mixes",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#mixin-and-mixes"},[(0,e.Lk)("span",null,[(0,e.Lk)("code",null,"@mixin"),(0,e.eW)(" and "),(0,e.Lk)("code",null,"@mixes")])])],-1),r={href:"https://jsdoc.app/tags-mixes",target:"_blank",rel:"noopener noreferrer"},u=(0,e.Lk)("code",null,"@mixin",-1),d=(0,e.Lk)("code",null,"@mixes",-1),k=(0,e.Lk)("strong",null,"Downside",-1),m=(0,e.Lk)("code",null,"@mixin",-1),v=(0,e.Lk)("code",null,"@mixes",-1),b={href:"https://jsdoc.app/tags-function",target:"_blank",rel:"noopener noreferrer"},y=(0,e.Lk)("code",null,"@function",-1),h={href:"https://jsdoc.app/tags-member",target:"_blank",rel:"noopener noreferrer"},g=(0,e.Lk)("code",null,"@member",-1),w=(0,e.Fv)('
import{ use, AbstractConcern }from"@aedart/support/concerns";\n\n/**\n * @mixin\n * @extendsAbstractConcern\n */\nclassShieldextendsAbstractConcern{\n\n /**\n * Returns the armor level\n *\n * @returns{number}\n */\n getarmor(){\n return8;\n }\n\n /**\n * Throw shield towards a target\n *\n * @param{object}target\n *\n * @returns{number} Damage given to target\n */\n throw(target){\n // target ignored here...\n return3;\n }\n}\n\n/**\n * @mixes Shield\n */\n@use([Shield,{\n 'throw':'fight'\n}])\nclassMonster{\n\n /**\n * Alias for {@link Shield#throw}\n *\n * @function fight\n * @param{object}target The target to throw at...\n * @return{number} Damage taken by target\n * @instance\n * @memberofMonster\n */\n\n /**\n * Do stuff...\n */\n do(){\n this.fight({});\n }\n}\n
Downside: Properties and methods described via @property are listed as "static" on the target class. Also, it is not possible to reuse existing JSDoc from your concern.
Downside: This approach can be very cumbersome. Also, reuse of JSDoc is not possible.
import{ use, AbstractConcern }from"@aedart/support/concerns";\n\nclassSwordextendsAbstractConcern{\n\n /**\n * Returns amount of damage\n *\n * @returns{number}\n */\n getslash(){\n return3;\n }\n\n /**\n * Returns the sword type\n *\n * @name type\n * @return{string}\n */\n gettype(){\n return'unique';\n }\n}\n\n\n@use([Sword,{\n 'slash':'damage'\n}])\nclassEnemy{\n\n /**\n * @public\n * @member{number} damage Alias for {@link Sword#slash}\n * @memberofEnemy\n */\n\n /**\n * @public\n * @member{string} type Alias for {@link Sword#type}\n * @memberofEnemy\n */\n}\n
',2),E={};var M=(0,a(6262).A)(E,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon"),E=(0,e.g2)("router-link"),M=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Most modern IDEs support "),(0,e.Lk)("a",o,[(0,e.eW)("JSDoc"),(0,e.bF)(a)]),(0,e.eW)(". They can improve your coding experience via code suggestions, highlights and other features. In this chapter, you will find a few ways that you can document your concerns and target class, via JSDoc.")]),(0,e.Lk)("nav",p,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(E,{to:"#mixin-and-mixes"},{default:(0,e.k6)((()=>[(0,e.eW)("@mixin and @mixes")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(E,{to:"#property"},{default:(0,e.k6)((()=>[(0,e.eW)("@property")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(E,{to:"#borrows"},{default:(0,e.k6)((()=>[(0,e.eW)("@borrows")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(E,{to:"#member"},{default:(0,e.k6)((()=>[(0,e.eW)("@member")])),_:1})])])]),(0,e.Lk)("div",l,[c,(0,e.Lk)("p",null,[(0,e.Lk)("em",null,[(0,e.eW)("If you are an expert in JSDoc, then you are most welcome to help improve this chapter. Please see the "),(0,e.bF)(M,{to:"/archive/current/contribution-guide.html"},{default:(0,e.k6)((()=>[(0,e.eW)("contribution guide")])),_:1}),(0,e.eW)(" for details on how you can contribute.")])])]),i,(0,e.Lk)("p",null,[(0,e.eW)("Possibly the easiest way to document your concern and target class that uses the concern, is via the "),(0,e.Lk)("a",r,[u,(0,e.eW)(" and "),d,(0,e.bF)(a)]),(0,e.eW)(" tags.")]),(0,e.Lk)("p",null,[k,(0,e.eW)(": "),(0,e.Lk)("em",null,[(0,e.eW)('Documenting "aliases" (known as virtual fields in the context of JSDoc) is not possible via '),m,(0,e.eW)(" and "),v,(0,e.eW)(". You can describe an alias via "),(0,e.Lk)("a",b,[y,(0,e.bF)(a)]),(0,e.eW)(" or "),(0,e.Lk)("a",h,[g,(0,e.bF)(a)]),(0,e.eW)(" tag.")])]),w,(0,e.Lk)("p",null,[(0,e.eW)("Another possibility is to describe properties and methods available in a target, via the "),(0,e.Lk)("a",f,[L,(0,e.bF)(a)]),(0,e.eW)(' tag. Doing so allows you to immediately describe the "alias" name.')]),x,(0,e.Lk)("p",null,[(0,e.eW)("The "),(0,e.Lk)("a",j,[W,(0,e.bF)(a)]),(0,e.eW)(" tag does also offer a possible way to describe aliases.")]),(0,e.Lk)("p",null,[D,(0,e.eW)(": "),(0,e.Lk)("em",null,[(0,e.eW)("You are still required to use "),(0,e.Lk)("a",S,[A,(0,e.bF)(a)]),(0,e.eW)(" tag to describe the actual aliases inside your target class.")])]),_,(0,e.Lk)("p",null,[(0,e.eW)("Lastly, you can use "),(0,e.Lk)("a",F,[C,(0,e.bF)(a)]),(0,e.eW)(" to describe all aliases directly, without relying on the "),(0,e.Lk)("a",q,[J,(0,e.bF)(a)]),(0,e.eW)(" tag.")]),R])}]]);const T=JSON.parse('{"path":"/archive/current/packages/support/concerns/jsdoc.html","title":"JSDoc","lang":"en-GB","frontmatter":{"title":"JSDoc","description":"A wat to document what concerns a targer class uses.","sidebarDepth":0},"headers":[{"level":2,"title":"@mixin and @mixes","slug":"mixin-and-mixes","link":"#mixin-and-mixes","children":[]},{"level":2,"title":"@property","slug":"property","link":"#property","children":[]},{"level":2,"title":"@borrows","slug":"borrows","link":"#borrows","children":[]},{"level":2,"title":"@member","slug":"member","link":"#member","children":[]}],"git":{"updatedTime":1709641376000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/concerns/jsdoc.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/last-updated.html.a20b6a02.js b/assets/js/last-updated.html.a20b6a02.js
new file mode 100644
index 00000000..513f8fdb
--- /dev/null
+++ b/assets/js/last-updated.html.a20b6a02.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[8518],{4306:function(n,e,a){a.r(e),a.d(e,{comp:function(){return f},data:function(){return h}});var s=a(641);const t=(0,s.Lk)("h1",{id:"last-updated",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#last-updated"},[(0,s.Lk)("span",null,"Last Updated")])],-1),o=(0,s.Lk)("code",null,"lastUpdatedPlugin()",-1),i={href:"https://v2.vuepress.vuejs.org/reference/default-theme/config.html#lastupdated",target:"_blank",rel:"noopener noreferrer"},l={href:"https://moment.github.io/luxon/#/",target:"_blank",rel:"noopener noreferrer"},p=(0,s.Lk)("h2",{id:"how-to-use",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#how-to-use"},[(0,s.Lk)("span",null,"How to use")])],-1),r={href:"https://v2.vuepress.vuejs.org/guide/configuration.html#config-file",target:"_blank",rel:"noopener noreferrer"},u=(0,s.Lk)("code",null,"lastUpdatedPlugin()",-1),d=(0,s.Fv)('
The plugin uses yyyy-MM-dd HH:mm:ss ZZZZ as default format, when none is given.
Example output: 2023-03-19 16:09:20 GMT+1
',2),v={};var f=(0,a(6262).A)(v,[["render",function(n,e){const a=(0,s.g2)("ExternalLinkIcon");return(0,s.uX)(),(0,s.CE)("div",null,[t,(0,s.Lk)("p",null,[o,(0,s.eW)(" allows you to specify a custom datetime format for the "),(0,s.Lk)("a",i,[(0,s.eW)('"last updated" date'),(0,s.bF)(a)]),(0,s.eW)(", for the default theme. It uses "),(0,s.Lk)("a",l,[(0,s.eW)("Luxon"),(0,s.bF)(a)]),(0,s.eW)(" to perform the formatting.")]),p,(0,s.Lk)("p",null,[(0,s.eW)("In your "),(0,s.Lk)("a",r,[(0,s.eW)("Config File"),(0,s.bF)(a)]),(0,s.eW)(", add the "),u,(0,s.eW)(":")]),d,(0,s.Lk)("p",null,[(0,s.eW)("Use the "),c,(0,s.eW)(" argument to specify your desired datetime format. See "),(0,s.Lk)("a",m,[(0,s.eW)("Luxon documentation"),(0,s.bF)(a)]),(0,s.eW)(" for available format tokens.")]),k])}]]);const h=JSON.parse('{"path":"/archive/current/packages/vuepress-utils/plugins/last-updated.html","title":"Last Updated","lang":"en-GB","frontmatter":{"title":"Last Updated","description":"Last Updated Date Vuepress plugins","sidebarDepth":0},"headers":[{"level":2,"title":"How to use","slug":"how-to-use","link":"#how-to-use","children":[]},{"level":2,"title":"Format","slug":"format","link":"#format","children":[]}],"git":{"updatedTime":1679756362000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/packages/vuepress-utils/plugins/last-updated.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/merge.html.e9720f9b.js b/assets/js/merge.html.e9720f9b.js
new file mode 100644
index 00000000..86fd43eb
--- /dev/null
+++ b/assets/js/merge.html.e9720f9b.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[8802],{6060:function(n,s,a){a.r(s),a.d(s,{comp:function(){return k},data:function(){return v}});var e=a(641);const t=(0,e.Lk)("h1",{id:"merge",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#merge"},[(0,e.Lk)("span",null,[(0,e.Lk)("code",null,"merge")])])],-1),p={href:"https://developer.mozilla.org/en-US/docs/Web/API/structuredClone",target:"_blank",rel:"noopener noreferrer"},o=(0,e.Lk)("code",null,"structuredClone",-1),c=(0,e.Fv)('
import{ merge }from'@aedart/support/arrays';\n\nconst a =[1,2,3];\nconst b =[4,5,6];\nconst c =[7,8,9];\n\nmerge(a, b, c);// [ 1, 2, 3, 4, 5, 6, 7, 8, 9 ]\n
const a ={foo:'foo'};\nconst b ={bar:'bar'};\nconst c ={ping:'pong'};\n\nconst result =merge([ a ],[ b, c ]);\n\nconsole.log(result[0]=== a);// false\nconsole.log(result[1]=== b);// false\nconsole.log(result[2]=== c);// false\n
In situations when values cannot be copied via structuredClone, an ArrayMergeError is thrown.
const a =[1,2,3];\nconst b =[function(){}];// A function cannot be deep copied...\n\nmerge(a, b);// ArrayMergeError\n
',4),d={};var k=(0,a(6262).A)(d,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("Merges arrays into a new array. This function attempts to deep copy values, using "),(0,e.Lk)("a",p,[o,(0,e.bF)(a)]),(0,e.eW)(".")]),c,(0,e.Lk)("p",null,[(0,e.eW)("Simple ("),l,(0,e.eW)(") objects "),(0,e.Lk)("a",i,[(0,e.eW)("deep copied"),(0,e.bF)(a)]),(0,e.eW)(". This means that new objects are returned in the resulting array.")]),(0,e.Lk)("p",null,[(0,e.eW)("See "),(0,e.Lk)("a",r,[(0,e.eW)("Mozilla's documentation"),(0,e.bF)(a)]),(0,e.eW)(" for additional information about what data types are supported.")]),u])}]]);const v=JSON.parse('{"path":"/archive/current/packages/support/arrays/merge.html","title":"Merge","lang":"en-GB","frontmatter":{"title":"Merge","description":"Merge multiple arrays into a new array.","sidebarDepth":0},"headers":[{"level":2,"title":"Deep Copy Objects","slug":"deep-copy-objects","link":"#deep-copy-objects","children":[]},{"level":2,"title":"When unable to merge values","slug":"when-unable-to-merge-values","link":"#when-unable-to-merge-values","children":[]}],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/arrays/merge.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},820:function(n,s,a){a.r(s),a.d(s,{comp:function(){return W},data:function(){return L}});var e=a(641);const t={id:"merge",tabindex:"-1"},p={class:"header-anchor",href:"#merge"},o=(0,e.Lk)("code",null,"merge",-1),c={href:"https://developer.mozilla.org/en-US/docs/Glossary/Deep_copy",target:"_blank",rel:"noopener noreferrer"},l={href:"https://developer.mozilla.org/en-US/docs/Web/API/structuredClone",target:"_blank",rel:"noopener noreferrer"},i=(0,e.Lk)("code",null,"structuredClone",-1),r={class:"table-of-contents"},u=(0,e.Fv)('
Example
import{ merge }from"@aedart/support/objects";\n\nconst person ={\n 'name':'Alice',\n};\n\nconst address ={\n 'address':{\n 'street':'Somewhere Street 43'\n },\n};\n\nconst result =merge(person, address);\n\nconsole.log(result);\n
The above shown example results in a new object that looks like this:
{\n "name":"Alice",\n "address":{\n "street":"Somewhere Street 43"\n }\n}\n
Property keys that are considered "unsafe", are never copied.
const a ={\n 'foo':'bar'\n};\nconst b ={\n __proto__:{'is_admin':true}\n}\n\nconst result =merge(a, b);\n\nconsole.log(result);// { 'foo': 'bar' }\nconsole.log(Reflect.has(result,'__proto__'));// false\n
For additional information about the merge callback, please review the source code of the defaultMergeCallback(), inside @aedart/support/objects.
',17),x={};var W=(0,a(6262).A)(x,[["render",function(n,s){const a=(0,e.g2)("Badge"),x=(0,e.g2)("ExternalLinkIcon"),W=(0,e.g2)("router-link"),L=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[o,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,e.Lk)("p",null,[(0,e.eW)("Merges objects recursively into a new object. The properties and values of the source objects are copied, using "),(0,e.Lk)("a",c,[(0,e.eW)("deep copy techniques"),(0,e.bF)(x)]),(0,e.eW)(", when possible. Behind the scene, most value types are deep copied via "),(0,e.Lk)("a",l,[i,(0,e.bF)(x)]),(0,e.eW)(".")]),(0,e.Lk)("nav",r,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#shallow-copied-types"},{default:(0,e.k6)((()=>[(0,e.eW)("Shallow Copied Types")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#unsafe-keys"},{default:(0,e.k6)((()=>[(0,e.eW)("Unsafe Keys")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#merge-options"},{default:(0,e.k6)((()=>[(0,e.eW)("Merge Options")])),_:1}),(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#depth"},{default:(0,e.k6)((()=>[(0,e.eW)("depth")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#skip"},{default:(0,e.k6)((()=>[(0,e.eW)("skip")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#overwritewithundefined"},{default:(0,e.k6)((()=>[(0,e.eW)("overwriteWithUndefined")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#usecloneable"},{default:(0,e.k6)((()=>[(0,e.eW)("useCloneable")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#mergearrays"},{default:(0,e.k6)((()=>[(0,e.eW)("mergeArrays")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(W,{to:"#callback"},{default:(0,e.k6)((()=>[(0,e.eW)("callback")])),_:1})])])])])]),u,(0,e.Lk)("p",null,[(0,e.eW)("Be default, the following value types are only "),(0,e.Lk)("a",d,[(0,e.eW)("shallow copied"),(0,e.bF)(x)]),(0,e.eW)(":")]),(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.Lk)("a",k,[(0,e.eW)("function"),(0,e.bF)(x)])]),(0,e.Lk)("li",null,[(0,e.Lk)("a",v,[(0,e.eW)("Symbol"),(0,e.bF)(x)])])]),m,(0,e.Lk)("p",null,[(0,e.Lk)("em",null,[(0,e.eW)("See "),(0,e.bF)(L,{to:"/archive/current/packages/support/reflections/isKeyUnsafe.html"},{default:(0,e.k6)((()=>[b])),_:1}),(0,e.eW)(" for additional details.")])]),g,(0,e.Lk)("p",null,[(0,e.eW)("Determines if an object's return value from a "),h,(0,e.eW)(" method ("),(0,e.Lk)("em",null,[(0,e.eW)("see "),(0,e.bF)(L,{to:"/archive/current/packages/support/objects/isCloneable.html"},{default:(0,e.k6)((()=>[y])),_:1})]),(0,e.eW)(") should be used for merging, rather than the source object itself.")]),f,(0,e.Lk)("p",null,[(0,e.eW)("When enabled, arrays, "),(0,e.bF)(L,{to:"/archive/current/packages/support/arrays/isArrayLike.html"},{default:(0,e.k6)((()=>[(0,e.eW)("array-like")])),_:1}),(0,e.eW)(", and "),(0,e.bF)(L,{to:"/archive/current/packages/support/arrays/isConcatSpreadable.html"},{default:(0,e.k6)((()=>[(0,e.eW)("concat spreadable")])),_:1}),(0,e.eW)(" objects are merged.")]),w,(0,e.Lk)("p",null,[(0,e.eW)("Behind the scene, the "),(0,e.bF)(L,{to:"/archive/current/packages/support/arrays/merge.html"},{default:(0,e.k6)((()=>[(0,e.eW)("array merge")])),_:1}),(0,e.eW)(" utility is used for merging arrays.")]),j])}]]);const L=JSON.parse('{"path":"/archive/current/packages/support/objects/merge.html","title":"Merge","lang":"en-GB","frontmatter":{"title":"Merge","description":"Merge multiple objects into a new object.","sidebarDepth":0},"headers":[{"level":2,"title":"Shallow Copied Types","slug":"shallow-copied-types","link":"#shallow-copied-types","children":[]},{"level":2,"title":"Unsafe Keys","slug":"unsafe-keys","link":"#unsafe-keys","children":[]},{"level":2,"title":"Merge Options","slug":"merge-options","link":"#merge-options","children":[{"level":3,"title":"depth","slug":"depth","link":"#depth","children":[]},{"level":3,"title":"skip","slug":"skip","link":"#skip","children":[]},{"level":3,"title":"overwriteWithUndefined","slug":"overwritewithundefined","link":"#overwritewithundefined","children":[]},{"level":3,"title":"useCloneable","slug":"usecloneable","link":"#usecloneable","children":[]},{"level":3,"title":"mergeArrays","slug":"mergearrays","link":"#mergearrays","children":[]},{"level":3,"title":"callback","slug":"callback","link":"#callback","children":[]}]}],"git":{"updatedTime":1709538877000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":4}]},"filePathRelative":"archive/current/packages/support/objects/merge.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/mergeKeys.html.f03ca1a1.js b/assets/js/mergeKeys.html.f03ca1a1.js
new file mode 100644
index 00000000..86896213
--- /dev/null
+++ b/assets/js/mergeKeys.html.f03ca1a1.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[338],{903:function(n,s,a){a.r(s),a.d(s,{comp:function(){return u},data:function(){return k}});var e=a(641);const t={id:"mergekeys",tabindex:"-1"},p={class:"header-anchor",href:"#mergekeys"},o=(0,e.Lk)("code",null,"mergeKeys",-1),c=(0,e.Lk)("code",null,"mergeKeys()",-1),i=(0,e.Lk)("code",null,"isKey()",-1),l=(0,e.Fv)('
',1),r={};var u=(0,a(6262).A)(r,[["render",function(n,s){const a=(0,e.g2)("Badge"),r=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[o,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.7",vertical:"middle"})])])]),(0,e.Lk)("p",null,[(0,e.eW)("The "),c,(0,e.eW)(" method is able to merge two or more keys into a single key ("),(0,e.Lk)("em",null,[(0,e.eW)("see "),(0,e.bF)(r,{to:"/archive/current/packages/support/misc/isKey.html"},{default:(0,e.k6)((()=>[i])),_:1})]),(0,e.eW)(").")]),l])}]]);const k=JSON.parse('{"path":"/archive/current/packages/support/misc/mergeKeys.html","title":"Merge Keys","lang":"en-GB","frontmatter":{"title":"Merge Keys","description":"Merge keys into a single key.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/misc/mergeKeys.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/newMixin.html.16d34cdd.js b/assets/js/newMixin.html.16d34cdd.js
new file mode 100644
index 00000000..ff0b768f
--- /dev/null
+++ b/assets/js/newMixin.html.16d34cdd.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9495],{6251:function(n,s,a){a.r(s),a.d(s,{comp:function(){return b},data:function(){return h}});var e=a(641);const t=(0,e.Lk)("h1",{id:"define-a-new-mixin",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#define-a-new-mixin"},[(0,e.Lk)("span",null,"Define a new Mixin")])],-1),o=(0,e.Lk)("code",null,"Mixin",-1),p={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/instanceof",target:"_blank",rel:"noopener noreferrer"},i=(0,e.Lk)("code",null,"instanceof",-1),c=(0,e.Lk)("code",null,"instanceof",-1),r=(0,e.Fv)('
import{ Mixin }from"@aedart/support/mixins";\n\nexportconst RectangleMixin =Mixin((superclass)=>classextends superclass {\n \n constructor(...args){\n super(...args);// Invoke parent constructor and pass on arugments!\n \n // Perform your initialisaiton logic...\n }\n \n // ...remaining not shown...\n});\n
',1),v={};var b=(0,a(6262).A)(v,[["render",function(n,s){const a=(0,e.g2)("ExternalLinkIcon"),v=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("You can use the "),o,(0,e.eW)(" decorator to define a new mixin. Amongst other things, the decorator will enable support for "),(0,e.Lk)("a",p,[i,(0,e.bF)(a)]),(0,e.eW)(" checks. See "),(0,e.bF)(v,{to:"/archive/current/packages/support/mixins/instanceof.html"},{default:(0,e.k6)((()=>[c,(0,e.eW)(" Operator")])),_:1}),(0,e.eW)(" for additional information.")]),r,(0,e.Lk)("p",null,[(0,e.eW)("If you need to perform initialisation logic in your mixins, then you can do so by implementing a class "),(0,e.Lk)("a",l,[u,(0,e.bF)(a)]),(0,e.eW)(". When doing so, it is important to invoke the parent constructor via "),(0,e.Lk)("a",d,[k,(0,e.bF)(a)]),(0,e.eW)(" and pass on eventual arguments.")]),m])}]]);const h=JSON.parse('{"path":"/archive/current/packages/support/mixins/newMixin.html","title":"New Mixin","lang":"en-GB","frontmatter":{"title":"New Mixin","description":"How to defined a new Mixin class.","sidebarDepth":0},"headers":[{"level":2,"title":"Constructor","slug":"constructor","link":"#constructor","children":[]}],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/mixins/newMixin.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/not_available.html.d2677aee.js b/assets/js/not_available.html.d2677aee.js
new file mode 100644
index 00000000..a72db108
--- /dev/null
+++ b/assets/js/not_available.html.d2677aee.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[1711],{8193:function(e,a,t){t.r(a),t.d(a,{comp:function(){return l},data:function(){return r}});var n=t(641);const i=[(0,n.Lk)("h1",{id:"not-available",tabindex:"-1"},[(0,n.Lk)("a",{class:"header-anchor",href:"#not-available"},[(0,n.Lk)("span",null,"Not Available")])],-1),(0,n.Lk)("p",null,[(0,n.Lk)("em",null,"The next version of Ion has yet to be designed and implemented. Come back at a later time to review the documentation...")],-1)],o={};var l=(0,t(6262).A)(o,[["render",function(e,a){return(0,n.uX)(),(0,n.CE)("div",null,i)}]]);const r=JSON.parse('{"path":"/archive/not_available.html","title":"Not Available","lang":"en-GB","frontmatter":{"title":"Not Available","description":"Next Ion Version","sidebarDepth":0},"headers":[],"git":{"updatedTime":1679232263000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/not_available.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/onward.html.d8a70010.js b/assets/js/onward.html.d8a70010.js
new file mode 100644
index 00000000..4498efc3
--- /dev/null
+++ b/assets/js/onward.html.d8a70010.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[8411],{2231:function(e,n,a){a.r(n),a.d(n,{comp:function(){return u},data:function(){return m}});var r=a(641);const t=(0,r.Lk)("h1",{id:"onward",tabindex:"-1"},[(0,r.Lk)("a",{class:"header-anchor",href:"#onward"},[(0,r.Lk)("span",null,"Onward")])],-1),i={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes/extends#mix-ins",target:"_blank",rel:"noopener noreferrer"},o=(0,r.Lk)("em",null,'"Mix-ins"',-1),s={href:"https://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/",target:"_blank",rel:"noopener noreferrer"},l=(0,r.Lk)("em",null,'"Real" Mixins with JavaScript Classes',-1),c={href:"https://justinfagnani.com/2016/01/07/enhancing-mixins-with-decorator-functions/",target:"_blank",rel:"noopener noreferrer"},d=(0,r.Lk)("em",null,"Enhancing Mixins with Decorator Functions",-1),p={};var u=(0,a(6262).A)(p,[["render",function(e,n){const a=(0,r.g2)("ExternalLinkIcon");return(0,r.uX)(),(0,r.CE)("div",null,[t,(0,r.Lk)("p",null,[(0,r.eW)("For more information and examples, please read Mozilla's documentation about "),(0,r.Lk)("a",i,[o,(0,r.bF)(a)]),(0,r.eW)(", and Justin Fagnani's blog posts:")]),(0,r.Lk)("ul",null,[(0,r.Lk)("li",null,[(0,r.Lk)("a",s,[l,(0,r.bF)(a)])]),(0,r.Lk)("li",null,[(0,r.Lk)("a",c,[d,(0,r.bF)(a)])])])])}]]);const m=JSON.parse('{"path":"/archive/current/packages/support/mixins/onward.html","title":"Onward","lang":"en-GB","frontmatter":{"title":"Onward","description":"Where to read more about mixins.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/mixins/onward.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/origin.html.8e0d9b78.js b/assets/js/origin.html.8e0d9b78.js
new file mode 100644
index 00000000..96dd0162
--- /dev/null
+++ b/assets/js/origin.html.8e0d9b78.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3066],{6885:function(e,n,r){r.r(n),r.d(n,{comp:function(){return d},data:function(){return g}});var a=r(641);const o=(0,a.Lk)("h1",{id:"origin",tabindex:"-1"},[(0,a.Lk)("a",{class:"header-anchor",href:"#origin"},[(0,a.Lk)("span",null,"Origin")])],-1),t={href:"https://aedart.github.io/athenaeum/",target:"_blank",rel:"noopener noreferrer"},i={href:"https://lerna.js.org/",target:"_blank",rel:"noopener noreferrer"},s={href:"https://www.typescriptlang.org/",target:"_blank",rel:"noopener noreferrer"},l={href:"https://en.wikipedia.org/wiki/Monorepo",target:"_blank",rel:"noopener noreferrer"},c=(0,a.Lk)("h2",{id:"meaning-of-ion",tabindex:"-1"},[(0,a.Lk)("a",{class:"header-anchor",href:"#meaning-of-ion"},[(0,a.Lk)("span",null,'Meaning of "Ion"')])],-1),m=(0,a.Lk)("em",null,"positive or negative",-1),p={href:"https://www.dictionary.com/browse/ion",target:"_blank",rel:"noopener noreferrer"},h={};var d=(0,r(6262).A)(h,[["render",function(e,n){const r=(0,a.g2)("ExternalLinkIcon");return(0,a.uX)(),(0,a.CE)("div",null,[o,(0,a.Lk)("p",null,[(0,a.eW)("For many years, I was too discouraged and overburden to publish my JavaScript as packages. Having a full-time job and maintaining "),(0,a.Lk)("a",t,[(0,a.eW)("Athenaeum"),(0,a.bF)(r)]),(0,a.eW)(" took most of my time. Like so many other developers, I was copying JavaScript from one project into another. I always knew that was very bad practice. But, it was too cumbersome trying to maintain so much code, spread throughout various repositories.")]),(0,a.Lk)("p",null,[(0,a.eW)("Nevertheless, in recent years, "),(0,a.Lk)("a",i,[(0,a.eW)("Lerna"),(0,a.bF)(r)]),(0,a.eW)(", "),(0,a.Lk)("a",s,[(0,a.eW)("TypeScript"),(0,a.bF)(r)]),(0,a.eW)(", and many other tools & frameworks made it somewhat easier to manage "),(0,a.Lk)("a",l,[(0,a.eW)("mono-repos"),(0,a.bF)(r)]),(0,a.eW)(". I cannot claim to have gained more time, but decided to give JavaScript packages another shoot.")]),c,(0,a.Lk)("blockquote",null,[(0,a.Lk)("p",null,[(0,a.eW)('"[...] An atom or a group of atoms that has an electric charge [...] - '),m,(0,a.eW)('" ('),(0,a.Lk)("a",p,[(0,a.eW)('"Scientific definition" from dictionary.com'),(0,a.bF)(r)]),(0,a.eW)(")")])])])}]]);const g=JSON.parse('{"path":"/archive/current/origin.html","title":"Origin","lang":"en-GB","frontmatter":{"description":"The origin of Ion","sidebarDepth":0},"headers":[{"level":2,"title":"Meaning of \\"Ion\\"","slug":"meaning-of-ion","link":"#meaning-of-ion","children":[]}],"git":{"updatedTime":1679938081000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":3}]},"filePathRelative":"archive/current/origin.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/outsideChanges.html.af38a077.js b/assets/js/outsideChanges.html.af38a077.js
new file mode 100644
index 00000000..88233c25
--- /dev/null
+++ b/assets/js/outsideChanges.html.af38a077.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[5180],{1276:function(n,a,s){s.r(a),s.d(a,{comp:function(){return p},data:function(){return c}});var e=s(641);const t=[(0,e.Fv)('
Whenever you read metadata, a copy is returned by the getMeta() method. This means that you can change the data, in your given context, but the original metadata remains the same.
import{ meta, getMeta }from'@aedart/support/meta';\n\n@meta('description',{name:'Search Service',alias:'Location Sercher'})\nclassService{}\n\n// Obtain "copy" and change it...\nlet desc =getMeta(Service,'description');\ndesc.name ='Country Searcher';\n\n// Original remains unchanged\ngetMeta(Service,'description').name;// Search Service\n
Caution
Only the meta decorator is intended to alter existing metadata - even if the value is an object. Please be mindful of this behaviour, whenever you change retrieved metadata using the getMeta() and getAllMeta() methods.
',4)],o={};var p=(0,s(6262).A)(o,[["render",function(n,a){return(0,e.uX)(),(0,e.CE)("div",null,t)}]]);const c=JSON.parse('{"path":"/archive/current/packages/support/meta/outsideChanges.html","title":"Outside Changes","lang":"en-GB","frontmatter":{"title":"Outside Changes","description":"About changes to metadata outside decorator scope.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/meta/outsideChanges.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/populate.html.e10419e6.js b/assets/js/populate.html.e10419e6.js
new file mode 100644
index 00000000..6cf41015
--- /dev/null
+++ b/assets/js/populate.html.e10419e6.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[7902],{5766:function(n,s,a){a.r(s),a.d(s,{comp:function(){return b},data:function(){return y}});var e=a(641);const t={id:"populate",tabindex:"-1"},p={class:"header-anchor",href:"#populate"},o=(0,e.Lk)("code",null,"populate",-1),c=(0,e.Lk)("code",null,"populate()",-1),l={href:"https://developer.mozilla.org/en-US/docs/Glossary/Shallow_copy",target:"_blank",rel:"noopener noreferrer"},i={class:"table-of-contents"},u=(0,e.Fv)('
keys: PropertyKey | PropertyKey[] | SourceKeysCallback = '*' - The keys to select and copy from source object. If wildcard (*) given, then all properties from the source are selected. If a callback is given, then that callback must return key or keys to select from source.
safe: boolean = true - When true, properties must exist in target (must be defined in target), before they are shallow copied.
By default, all keys (*) from the source object are attempted populated into the target. You can limit what properties can be populated, by specifying what keys are allowed to be populated.
When the safe argument is set to true (default behavior), and a property key does not exist in the target object, then a TypeError is thrown.
classPerson{\n name =null;\n age =null;\n\n constructor(data){\n populate(this, data,['name','age','phone']);\n }\n}\n\nconst instance =newPerson({\n name:'Janine',\n age:36,\n phone:'555 555 555'\n});// TypeError - phone does not exist in target \n
However, if a requested key does not exist in the source object, then a TypeError is thrown regardless of the safe argument value.
classPerson{\n name =null;\n age =null;\n\n constructor(data){\n populate(this, data,['name','age','phone'],false);\n }\n}\n\nconst instance =newPerson({\n name:'Janine',\n age:36\n});// TypeError - phone does not exist in source \n
',12),v={};var b=(0,a(6262).A)(v,[["render",function(n,s){const a=(0,e.g2)("Badge"),v=(0,e.g2)("ExternalLinkIcon"),b=(0,e.g2)("router-link"),y=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[o,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.9",vertical:"middle"})])])]),(0,e.Lk)("p",null,[(0,e.eW)("The "),c,(0,e.eW)(" allows you to populate a target object's properties with those from a source object. The values are "),(0,e.Lk)("a",l,[(0,e.eW)("shallow copied"),(0,e.bF)(v)]),(0,e.eW)(".")]),(0,e.Lk)("nav",i,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#arguments"},{default:(0,e.k6)((()=>[(0,e.eW)("Arguments")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#limit-keys-to-populate"},{default:(0,e.k6)((()=>[(0,e.eW)("Limit keys to populate")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#source-keys-callback"},{default:(0,e.k6)((()=>[(0,e.eW)("Source Keys Callback")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#when-keys-do-not-exist"},{default:(0,e.k6)((()=>[(0,e.eW)("When keys do not exist")])),_:1})])])]),u,(0,e.Lk)("div",r,[k,(0,e.Lk)("p",null,[(0,e.bF)(y,{to:"/archive/current/packages/support/reflections/isKeyUnsafe.html"},{default:(0,e.k6)((()=>[(0,e.eW)('"Unsafe" properties')])),_:1}),(0,e.eW)(" are disregarded, regardless of what "),d,(0,e.eW)(" are given.")])]),m])}]]);const y=JSON.parse('{"path":"/archive/current/packages/support/objects/populate.html","title":"Populate","lang":"en-GB","frontmatter":{"title":"Populate","description":"Populate target object.","sidebarDepth":0},"headers":[{"level":2,"title":"Arguments","slug":"arguments","link":"#arguments","children":[]},{"level":2,"title":"Limit keys to populate","slug":"limit-keys-to-populate","link":"#limit-keys-to-populate","children":[]},{"level":2,"title":"Source Keys Callback","slug":"source-keys-callback","link":"#source-keys-callback","children":[]},{"level":2,"title":"When keys do not exist","slug":"when-keys-do-not-exist","link":"#when-keys-do-not-exist","children":[]}],"git":{"updatedTime":1709649075000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":2}]},"filePathRelative":"archive/current/packages/support/objects/populate.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/prerequisites.html.1c3df408.js b/assets/js/prerequisites.html.1c3df408.js
new file mode 100644
index 00000000..a43935d7
--- /dev/null
+++ b/assets/js/prerequisites.html.1c3df408.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[4261],{840:function(e,r,t){t.r(r),t.d(r,{comp:function(){return c},data:function(){return l}});var s=t(641);const a=(0,s.Lk)("h1",{id:"prerequisites",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#prerequisites"},[(0,s.Lk)("span",null,"Prerequisites")])],-1),o={href:"https://github.com/tc39/proposal-decorators",target:"_blank",rel:"noopener noreferrer"},n={href:"https://babeljs.io/docs/babel-plugin-proposal-decorators",target:"_blank",rel:"noopener noreferrer"},i={href:"https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-0.html#decorators",target:"_blank",rel:"noopener noreferrer"},p={};var c=(0,t(6262).A)(p,[["render",function(e,r){const t=(0,s.g2)("ExternalLinkIcon");return(0,s.uX)(),(0,s.CE)("div",null,[a,(0,s.Lk)("p",null,[(0,s.eW)("At the time of this writing, "),(0,s.Lk)("a",o,[(0,s.eW)("decorators"),(0,s.bF)(t)]),(0,s.eW)(" are still in a proposal phase. To use concerns, you must either use "),(0,s.Lk)("a",n,[(0,s.eW)("@babel/plugin-proposal-decorators"),(0,s.bF)(t)]),(0,s.eW)(", or use "),(0,s.Lk)("a",i,[(0,s.eW)("TypeScript 5 decorators"),(0,s.bF)(t)]),(0,s.eW)(".")])])}]]);const l=JSON.parse('{"path":"/archive/current/packages/support/concerns/prerequisites.html","title":"Prerequisites","lang":"en-GB","frontmatter":{"title":"Prerequisites","description":"Prerequisites for using concerns.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709641376000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/concerns/prerequisites.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')},5265:function(e,r,t){t.r(r),t.d(r,{comp:function(){return c},data:function(){return l}});var s=t(641);const a=(0,s.Lk)("h1",{id:"prerequisites",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#prerequisites"},[(0,s.Lk)("span",null,"Prerequisites")])],-1),o={href:"https://github.com/tc39/proposal-decorators",target:"_blank",rel:"noopener noreferrer"},n={href:"https://babeljs.io/docs/babel-plugin-proposal-decorators",target:"_blank",rel:"noopener noreferrer"},i={href:"https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-0.html#decorators",target:"_blank",rel:"noopener noreferrer"},p={};var c=(0,t(6262).A)(p,[["render",function(e,r){const t=(0,s.g2)("ExternalLinkIcon");return(0,s.uX)(),(0,s.CE)("div",null,[a,(0,s.Lk)("p",null,[(0,s.eW)("At the time of this writing, "),(0,s.Lk)("a",o,[(0,s.eW)("decorators"),(0,s.bF)(t)]),(0,s.eW)(" are still in a proposal phase. To use the meta decorator, you must either use "),(0,s.Lk)("a",n,[(0,s.eW)("@babel/plugin-proposal-decorators"),(0,s.bF)(t)]),(0,s.eW)(", or use "),(0,s.Lk)("a",i,[(0,s.eW)("TypeScript 5 decorators"),(0,s.bF)(t)]),(0,s.eW)(".")])])}]]);const l=JSON.parse('{"path":"/archive/current/packages/support/meta/prerequisites.html","title":"Prerequisites","lang":"en-GB","frontmatter":{"title":"Prerequisites","description":"Prerequisites for using meta decorators.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/meta/prerequisites.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/runtime~app.b89f1dfd.js b/assets/js/runtime~app.b89f1dfd.js
new file mode 100644
index 00000000..d169902b
--- /dev/null
+++ b/assets/js/runtime~app.b89f1dfd.js
@@ -0,0 +1 @@
+!function(){"use strict";var e,t,r,a={},l={};function o(e){var t=l[e];if(void 0!==t)return t.exports;var r=l[e]={exports:{}};return a[e](r,r.exports,o),r.exports}o.m=a,e=[],o.O=function(t,r,a,l){if(!r){var n=1/0;for(f=0;f=l)&&Object.keys(o.O).every((function(e){return o.O[e](r[s])}))?r.splice(s--,1):(i=!1,l0&&e[f-1][2]>l;f--)e[f]=e[f-1];e[f]=[r,a,l]},o.d=function(e,t){for(var r in t)o.o(t,r)&&!o.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},o.f={},o.e=function(e){return Promise.all(Object.keys(o.f).reduce((function(t,r){return o.f[r](e,t),t}),[]))},o.u=function(e){return"assets/js/"+{86:"booting.html",338:"mergeKeys.html",469:"install.html",572:"getClassPropertyDescriptor.html",676:"targetMeta.html",754:"get.html",984:"classOwnKeys.html",1705:"getNameOrDesc.html",1711:"not_available.html",1816:"customErrors.html",1901:"hasAllMethods.html",2021:"tc39.html",2023:"classLooksLike.html",2822:"hooks.html",2846:"code-of-conduct.html",3066:"origin.html",3082:"isSubclass.html",3100:"archive.html",3246:"has.html",3248:"supported.html",3287:"hasPrototypeProperty.html",3295:"empty.html",3503:"getAllParentsOfClass.html",3518:"set.html",3717:"setAndGet.html",3783:"configureStackTrace.html",4261:"prerequisites.html",4470:"index.html",4610:"includesAll.html",4648:"isSubclassOrLooksLike.html",4795:"isKeyUnsafe.html",4975:"contribution-guide.html",4993:"forget.html",5067:"getParentOfClass.html",5180:"outsideChanges.html",5394:"isPropertyKey.html",5646:"instanceof.html",5807:"configureCustomError.html",5815:"upgrade-guide.html",5943:"includesAny.html",6054:"uniqueId.html",6247:"isCloneable.html",6262:"apply.html",6321:"isPopulatable.html",6333:"usage.html",6368:"version-disclaimer.html",6406:"inheritance.html",6529:"isKey.html",6745:"jsdoc.html",6805:"isTypedArray.html",7044:"isArrayLike.html",7428:"conflictResolution.html",7490:"404.html",7627:"isConcatSpreadable.html",7902:"populate.html",7920:"edgeCases.html",7922:"forgetAll.html",8071:"isSafeArrayLike.html",8411:"onward.html",8423:"hasAll.html",8483:"hasMethod.html",8518:"last-updated.html",8802:"merge.html",8852:"hasUniqueId.html",8874:"isConstructor.html",8925:"assertHasPrototypeProperty.html",9058:"isWeakKind.html",9061:"descTag.html",9088:"isKeySafe.html",9127:"getErrorMessage.html",9150:"hasAny.html",9383:"isPrimitive.html",9414:"security.html",9443:"getClassPropertyDescriptors.html",9495:"newMixin.html",9502:"isset.html",9583:"getConstructorName.html",9628:"concernClass.html",9912:"toWeakRef.html",9994:"aliases.html"}[e]+"."+{86:"7fb86557",338:"f03ca1a1",469:"3a4e0937",572:"184c403f",676:"d9e6a717",754:"031c6187",984:"083ccde1",1705:"6c2642af",1711:"d2677aee",1816:"03ae048e",1901:"194f3e31",2021:"40e10d75",2023:"a8409fa2",2822:"a0da77d5",2846:"2cd0f919",3066:"8e0d9b78",3082:"cec896be",3100:"822a3aab",3246:"c6f27798",3248:"4f3e2f6f",3287:"f0d6526f",3295:"0cbc3fef",3503:"d8b9749c",3518:"fe002971",3717:"7a51fc70",3783:"4ad574a1",4261:"1c3df408",4470:"5b4548ed",4610:"b83b88e2",4648:"a105780a",4795:"b2e04d30",4975:"9d1069c0",4993:"678760e4",5067:"844074cb",5180:"af38a077",5394:"16e05935",5646:"305d63a2",5807:"a937c58f",5815:"05a299ae",5943:"90c6798f",6054:"7370e18c",6247:"29b12a95",6262:"e3961839",6321:"f13a1d66",6333:"740ce24f",6368:"b653dfc9",6406:"8b78f5ff",6529:"e4b8f164",6745:"fc513c7e",6805:"85c74ae6",7044:"d228cb77",7428:"84b254f4",7490:"636faa69",7627:"af5da527",7902:"e10419e6",7920:"1cf6a40e",7922:"221e6917",8071:"9513dd4f",8411:"d8a70010",8423:"51adf6fd",8483:"b8b97f0e",8518:"a20b6a02",8802:"e9720f9b",8852:"b9df194e",8874:"776fdd64",8925:"47d85a67",9058:"30eab0a8",9061:"f3d94e17",9088:"bd9f806e",9127:"4590141f",9150:"a9e65a87",9383:"a0540d19",9414:"873c4b9f",9443:"d746e1f4",9495:"16d34cdd",9502:"0803475b",9583:"71e9279b",9628:"392f500d",9912:"4afb7262",9994:"1104c1b8"}[e]+".js"},o.miniCssF=function(e){},o.o=function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},t={},r="@aedart/ion-monorepo:",o.l=function(e,a,l,n){if(t[e])t[e].push(a);else{var i,s;if(void 0!==l)for(var c=document.getElementsByTagName("script"),f=0;fHow to report a vulnerability
If you have discovered a vulnerability, please send an encrypted email to Alin Eugen Deac (aedart@gmail.com). Use the public PGP key listed below for encryption. Your email will be prioritised and addressed as quickly as possible.
In addition, please make sure that the contents of your email contains appropriate information about the vulnerability. E.g.:
Where the vulnerability is located
Why it is a vulnerability
Affected version(s)
(How it can be resolved, if you have a possible solution)
',4),d={class:"custom-container tip"},u=(0,l.Lk)("p",{class:"custom-container-title"},"How to encrypt emails using PGP",-1),o=(0,l.Lk)("p",null,"If you do not know how to use PGP encryption, then the following can help you",-1),c={href:"https://youtu.be/Ro3MSBS9w-A",target:"_blank",rel:"noopener noreferrer"},v={href:"https://github.com/mailvelope/mailvelope",target:"_blank",rel:"noopener noreferrer"},p={href:"https://sela.io/pgp-en/",target:"_blank",rel:"noopener noreferrer"},m=(0,l.Fv)('
',3),b={};var h=(0,n(6262).A)(b,[["render",function(e,i){const n=(0,l.g2)("router-link"),b=(0,l.g2)("ExternalLinkIcon"),h=(0,l.g2)("RouteLink");return(0,l.uX)(),(0,l.CE)("div",null,[s,r,(0,l.Lk)("nav",a,[(0,l.Lk)("ul",null,[(0,l.Lk)("li",null,[(0,l.bF)(n,{to:"#how-to-report-a-vulnerability"},{default:(0,l.k6)((()=>[(0,l.eW)("How to report a vulnerability")])),_:1}),(0,l.Lk)("ul",null,[(0,l.Lk)("li",null,[(0,l.bF)(n,{to:"#public-pgp-key"},{default:(0,l.k6)((()=>[(0,l.eW)("Public PGP Key")])),_:1})])])]),(0,l.Lk)("li",null,[(0,l.bF)(n,{to:"#supported-versions"},{default:(0,l.k6)((()=>[(0,l.eW)("Supported Versions")])),_:1})])])]),t,(0,l.Lk)("div",d,[u,o,(0,l.Lk)("ul",null,[(0,l.Lk)("li",null,[(0,l.Lk)("a",c,[(0,l.eW)("How to Use PGP Encryption With Gmail and Other Web Email With Mailvelope"),(0,l.bF)(b)])]),(0,l.Lk)("li",null,[(0,l.Lk)("a",v,[(0,l.eW)("Mailvelope - Browser Extension"),(0,l.bF)(b)])]),(0,l.Lk)("li",null,[(0,l.Lk)("a",p,[(0,l.eW)("Sela - Online PGP Encrypt & Decrypt"),(0,l.bF)(b)])])])]),m,(0,l.Lk)("p",null,[(0,l.eW)("Please read the "),(0,l.bF)(h,{to:"/archive/current/#support-policy"},{default:(0,l.k6)((()=>[(0,l.eW)("Support Policy")])),_:1}),(0,l.eW)(" for additional information about what versions are supported.")])])}]]);const g=JSON.parse('{"path":"/archive/current/security.html","title":"Security Policy","lang":"en-GB","frontmatter":{"description":"Security Policy of Athenaeum","sidebarDepth":0},"headers":[{"level":2,"title":"How to report a vulnerability","slug":"how-to-report-a-vulnerability","link":"#how-to-report-a-vulnerability","children":[{"level":3,"title":"Public PGP Key","slug":"public-pgp-key","link":"#public-pgp-key","children":[]}]},{"level":2,"title":"Supported Versions","slug":"supported-versions","link":"#supported-versions","children":[]}],"git":{"updatedTime":1679232326000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/security.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/set.html.fe002971.js b/assets/js/set.html.fe002971.js
new file mode 100644
index 00000000..d61dee80
--- /dev/null
+++ b/assets/js/set.html.fe002971.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3518],{9819:function(n,a,s){s.r(a),s.d(a,{comp:function(){return l},data:function(){return r}});var t=s(641);const e=(0,t.Lk)("h1",{id:"set",tabindex:"-1"},[(0,t.Lk)("a",{class:"header-anchor",href:"#set"},[(0,t.Lk)("span",null,[(0,t.Lk)("code",null,"set")])])],-1),o={href:"https://lodash.com/docs/4.17.15#set",target:"_blank",rel:"noopener noreferrer"},p=(0,t.Lk)("code",null,"set",-1),c=(0,t.Fv)('
',1),i={};var l=(0,s(6262).A)(i,[["render",function(n,a){const s=(0,t.g2)("ExternalLinkIcon");return(0,t.uX)(),(0,t.CE)("div",null,[e,(0,t.Lk)("p",null,[(0,t.eW)("Set a value in object at given path. "),(0,t.Lk)("em",null,[(0,t.eW)("Method is an alias for "),(0,t.Lk)("a",o,[(0,t.eW)("Lodash "),p,(0,t.bF)(s)]),(0,t.eW)(".")])]),c])}]]);const r=JSON.parse('{"path":"/archive/current/packages/support/objects/set.html","title":"Set","lang":"en-GB","frontmatter":{"title":"Set","description":"Set value in object path.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/set.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/setAndGet.html.7a51fc70.js b/assets/js/setAndGet.html.7a51fc70.js
new file mode 100644
index 00000000..0b205e56
--- /dev/null
+++ b/assets/js/setAndGet.html.7a51fc70.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3717],{3321:function(a,n,s){s.r(n),s.d(n,{comp:function(){return w},data:function(){return L}});var e=s(641);const t=(0,e.Lk)("h1",{id:"set-and-get-metadata",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#set-and-get-metadata"},[(0,e.Lk)("span",null,"Set and Get Metadata")])],-1),o={class:"table-of-contents"},l=(0,e.Lk)("h2",{id:"set-metadata",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#set-metadata"},[(0,e.Lk)("span",null,"Set Metadata")])],-1),p=(0,e.Lk)("p",null,[(0,e.eW)("To define metadata on a class or its elements, use "),(0,e.Lk)("code",null,"meta()"),(0,e.eW)(". It accepts the following arguments:")],-1),c=(0,e.Lk)("code",null,"key",-1),i=(0,e.Lk)("code",null,"set",-1),r=(0,e.Lk)("code",null,"value",-1),u={href:"https://developer.mozilla.org/en-US/docs/Glossary/Primitive",target:"_blank",rel:"noopener noreferrer"},d={href:"https://developer.mozilla.org/en-US/docs/Glossary/Object",target:"_blank",rel:"noopener noreferrer"},k={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function",target:"_blank",rel:"noopener noreferrer"},m=(0,e.Fv)('
To obtain metadata, use the getMeta() method. You can also use getAllMeta(), if you wish to obtain all available metadata for a target class.
import{ meta }from'@aedart/support/meta';\n\n@meta('service_alias','locationSearcher')\nclassService\n{\n @meta('name','Name of service') name;\n \n @meta('fetch.desc','Fetches resource via a gateway')\n @meta('fetch.dependencies',['my-gateway'])\n asyncfetch(gateway)\n {\n // ...implementation not shown...\n }\n}\n
Depending on the kind of element that is decorated, metadata might only become available for reading, after a new class instance has been instantiated. This is true for the following elements:
If you need to create more advanced metadata, you can specify a callback as the first argument for the meta() decorator method. When using a callback you gain access to the target that is being decorated, as well as the decorator context. The callback MUST return an object that contains a key and a value property.
Although the above example is a bit cumbersome to read, it shows a simple way to defined metadata for a method, which utilises the decorator context. If you wish, you can use this approach to create your own specialised meta decorators. Doing so can also improve the readability of your class. Consider the following example:
',8),y={};var w=(0,s(6262).A)(y,[["render",function(a,n){const s=(0,e.g2)("router-link"),y=(0,e.g2)("RouteLink"),w=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("nav",o,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(s,{to:"#set-metadata"},{default:(0,e.k6)((()=>[(0,e.eW)("Set Metadata")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(s,{to:"#get-metadata"},{default:(0,e.k6)((()=>[(0,e.eW)("Get Metadata")])),_:1}),(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(s,{to:"#default-value"},{default:(0,e.k6)((()=>[(0,e.eW)("Default Value")])),_:1})])])]),(0,e.Lk)("li",null,[(0,e.bF)(s,{to:"#callback"},{default:(0,e.k6)((()=>[(0,e.eW)("Callback")])),_:1})])])]),l,p,(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[c,(0,e.eW)(": "),(0,e.Lk)("em",null,[(0,e.eW)("name of metadata identifier. Can also be a path ("),(0,e.Lk)("em",null,[(0,e.eW)("see "),(0,e.bF)(y,{to:"/archive/current/packages/support/objects/set.html"},{default:(0,e.k6)((()=>[i])),_:1})]),(0,e.eW)(").")])]),(0,e.Lk)("li",null,[r,(0,e.eW)(": "),(0,e.Lk)("em",null,[(0,e.eW)("arbitrary data. Can be a "),(0,e.Lk)("a",u,[(0,e.eW)("primitive value"),(0,e.bF)(w)]),(0,e.eW)(", an "),(0,e.Lk)("a",d,[(0,e.eW)("object"),(0,e.bF)(w)]),(0,e.eW)(", or a "),(0,e.Lk)("a",k,[(0,e.eW)("function"),(0,e.bF)(w)]),(0,e.eW)(".")])])]),m,(0,e.Lk)("div",v,[b,(0,e.Lk)("p",null,[(0,e.eW)("If an element is declared as "),(0,e.Lk)("a",g,[h,(0,e.bF)(w)]),(0,e.eW)(", then it's metadata becomes available as soon as the class has been defined.")])]),f])}]]);const L=JSON.parse('{"path":"/archive/current/packages/support/meta/setAndGet.html","title":"Set & Get","lang":"en-GB","frontmatter":{"title":"Set & Get","description":"Defining and retrieving metadata.","sidebarDepth":0},"headers":[{"level":2,"title":"Set Metadata","slug":"set-metadata","link":"#set-metadata","children":[]},{"level":2,"title":"Get Metadata","slug":"get-metadata","link":"#get-metadata","children":[{"level":3,"title":"Default Value","slug":"default-value","link":"#default-value","children":[]}]},{"level":2,"title":"Callback","slug":"callback","link":"#callback","children":[]}],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/meta/setAndGet.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/supported.html.4f3e2f6f.js b/assets/js/supported.html.4f3e2f6f.js
new file mode 100644
index 00000000..89e41b58
--- /dev/null
+++ b/assets/js/supported.html.4f3e2f6f.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[3248],{2302:function(e,t,o){o.r(t),o.d(t,{comp:function(){return l},data:function(){return c}});var r=o(641);const a=(0,r.Fv)('
The meta decorator supports the following elements¹:
class
method
getter
setter
field
accessor
',3),n={href:"https://github.com/tc39/proposal-decorators#2-calling-decorators",target:"_blank",rel:"noopener noreferrer"},s=(0,r.Lk)("code",null,"context.kind",-1),d={};var l=(0,o(6262).A)(d,[["render",function(e,t){const o=(0,r.g2)("ExternalLinkIcon");return(0,r.uX)(),(0,r.CE)("div",null,[a,(0,r.Lk)("p",null,[(0,r.eW)("¹: "),(0,r.Lk)("em",null,[(0,r.eW)("An element is determined by the decorator's "),(0,r.Lk)("a",n,[s,(0,r.bF)(o)]),(0,r.eW)(" property.")])])])}]]);const c=JSON.parse('{"path":"/archive/current/packages/support/meta/supported.html","title":"Supported Elements","lang":"en-GB","frontmatter":{"title":"Supported Elements","description":"Supported elements by meta decorators.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/meta/supported.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/targetMeta.html.d9e6a717.js b/assets/js/targetMeta.html.d9e6a717.js
new file mode 100644
index 00000000..34db6553
--- /dev/null
+++ b/assets/js/targetMeta.html.d9e6a717.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[676],{3037:function(n,s,a){a.r(s),a.d(s,{comp:function(){return b},data:function(){return g}});var e=a(641);const t={id:"target-meta",tabindex:"-1"},p={class:"header-anchor",href:"#target-meta"},c=(0,e.Lk)("p",null,[(0,e.eW)("The "),(0,e.Lk)("code",null,"targetMeta()"),(0,e.eW)(" decorator offers the ability to associate metadata directly with a class instance or class method reference. This can be useful in situations when you do not know the class that owns the metadata.")],-1),i=(0,e.Lk)("code",null,"targetMeta()",-1),o=(0,e.Lk)("code",null,"meta()",-1),l={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap",target:"_blank",rel:"noopener noreferrer"},r=(0,e.Lk)("code",null,"WeakMap",-1),u={class:"table-of-contents"},d=(0,e.Lk)("h2",{id:"supported-elements",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#supported-elements"},[(0,e.Lk)("span",null,"Supported Elements")])],-1),k=(0,e.Lk)("code",null,"meta()",-1),m=(0,e.Lk)("code",null,"targetMeta()",-1),v=(0,e.Fv)('
Target meta is automatically inherited by subclasses and can also be overwritten, similar to that of the meta() decorator.
Example: classes
import{targetMeta, getTargetMeta}from'@aedart/support/meta';\n\n@meta('service_alias','locationSearcher')\nclassService{}\n\nclassCitySearcherextendsService{}\n\nconst instance =newCitySearcher();\n\n// ...later in your application...\ngetTargetMeta(instance,'service_alias');// locationSearcher\n
Inheritance for static methods works a bit differently. By default, any subclass will automatically inherit target metadata, even for static methods. However, if you overwrite the given static method, the metadata is lost.
Limitation
When a static method is overwritten, the parent's "target" metadata cannot be obtained due to a general limitation of the meta() decorator. The decorator has no late this binding available to the overwritten static method. This makes it impossible to associate the overwritten static method with metadata from the parent.
Example: inheritance for static methods
import{targetMeta, getTargetMeta}from'@aedart/support/meta';\n\nclassService{\n\n @targetMeta('dependencies',['xmlClient'])\n staticsearch(client){\n // ...not shown...\n }\n}\n\nclassCountrySearcherextendsService{\n // ... not method overwrite here...\n}\n\nclassCitySearcherextendsService{\n \n // Overwite of static method - target meta is lost\n staticsearch(client){}\n}\n\n// ...later in your application...\ngetTargetMeta(CountrySearcher.search,'dependencies');// [ 'xmlClient' ]\ngetTargetMeta(CitySearcher.search,'dependencies');// undefined\n
To overcome the above shown issue, you can use the inheritTargetMeta() decorator. It forces the static method to "copy" metadata from its parent, if available.
Example: force inheritance for static methods
import{\n targetMeta,\n getTargetMeta,\n inheritTargetMeta\n}from'@aedart/support/meta';\n\nclassService{\n\n @targetMeta('dependencies',['xmlClient'])\n staticsearch(client){\n // ...not shown...\n }\n}\n\nclassCountrySearcherextendsService{\n // ... not method overwrite here...\n}\n\nclassCitySearcherextendsService{\n \n @inheritTargetMeta()\n staticsearch(client){}\n}\n\n// ...later in your application...\ngetTargetMeta(CountrySearcher.search,'dependencies');// [ 'xmlClient' ]\ngetTargetMeta(CitySearcher.search,'dependencies');// [ 'xmlClient' ]\n
',21),h={};var b=(0,a(6262).A)(h,[["render",function(n,s){const a=(0,e.g2)("Badge"),h=(0,e.g2)("ExternalLinkIcon"),b=(0,e.g2)("router-link"),g=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",p,[(0,e.Lk)("span",null,[(0,e.eW)("Target Meta "),(0,e.bF)(a,{type:"tip",text:"Available since v0.7",vertical:"middle"})])])]),c,(0,e.Lk)("p",null,[(0,e.eW)("Behind the scene, "),i,(0,e.eW)(" uses the "),o,(0,e.eW)(" decorator and stores a reference to the target that is decorated inside a "),(0,e.Lk)("a",l,[r,(0,e.bF)(h)]),(0,e.eW)(".")]),(0,e.Lk)("nav",u,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#supported-elements"},{default:(0,e.k6)((()=>[(0,e.eW)("Supported Elements")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#class-instance"},{default:(0,e.k6)((()=>[(0,e.eW)("Class Instance")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#method-reference"},{default:(0,e.k6)((()=>[(0,e.eW)("Method Reference")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#inheritance"},{default:(0,e.k6)((()=>[(0,e.eW)("Inheritance")])),_:1}),(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(b,{to:"#static-methods"},{default:(0,e.k6)((()=>[(0,e.eW)("Static Methods")])),_:1})])])])])]),d,(0,e.Lk)("p",null,[(0,e.eW)("Unlike the "),(0,e.bF)(g,{to:"/archive/current/packages/support/meta/supported.html"},{default:(0,e.k6)((()=>[k,(0,e.eW)(" decorator")])),_:1}),(0,e.eW)(", "),m,(0,e.eW)(" only supports the following elements:")]),v])}]]);const g=JSON.parse('{"path":"/archive/current/packages/support/meta/targetMeta.html","title":"Target Meta","lang":"en-GB","frontmatter":{"title":"Target Meta","description":"Associate metadata with a class instance or class method reference.","sidebarDepth":0},"headers":[{"level":2,"title":"Supported Elements","slug":"supported-elements","link":"#supported-elements","children":[]},{"level":2,"title":"Class Instance","slug":"class-instance","link":"#class-instance","children":[]},{"level":2,"title":"Method Reference","slug":"method-reference","link":"#method-reference","children":[]},{"level":2,"title":"Inheritance","slug":"inheritance","link":"#inheritance","children":[{"level":3,"title":"Static Methods","slug":"static-methods","link":"#static-methods","children":[]}]}],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/meta/targetMeta.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/tc39.html.40e10d75.js b/assets/js/tc39.html.40e10d75.js
new file mode 100644
index 00000000..08376609
--- /dev/null
+++ b/assets/js/tc39.html.40e10d75.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[2021],{8338:function(a,n,s){s.r(n),s.d(n,{comp:function(){return h},data:function(){return g}});var e=s(641);const t=(0,e.Lk)("h1",{id:"tc39-decorator-metadata",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#tc39-decorator-metadata"},[(0,e.Lk)("span",null,"TC39 Decorator Metadata")])],-1),o={href:"https://github.com/tc39/proposal-decorator-metadata",target:"_blank",rel:"noopener noreferrer"},p=(0,e.Lk)("em",null,'"mimics"',-1),c=(0,e.Lk)("code",null,"context.metadata",-1),l=(0,e.Lk)("code",null,"Symbol.metadata",-1),r=(0,e.Fv)('
(Above shown example is very simplified. Actual implementation is a bit more complex...)
',5),i=(0,e.Lk)("code",null,"meta",-1),u={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap",target:"_blank",rel:"noopener noreferrer"},d=(0,e.Lk)("code",null,"WeakMap",-1),k={href:"https://github.com/tc39/proposal-decorator-metadata",target:"_blank",rel:"noopener noreferrer"},m=(0,e.Lk)("code",null,"context.metadata",-1),v=(0,e.Lk)("em",null,"or when browsers support it",-1),b={};var h=(0,s(6262).A)(b,[["render",function(a,n){const s=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("In relation to the "),(0,e.Lk)("a",o,[(0,e.eW)("Decorator Metadata proposal"),(0,e.bF)(s)]),(0,e.eW)(", this decorator "),p,(0,e.eW)(" a similar behaviour as the one defined by the proposal. Defining and retrieving metadata relies on a decorator's "),c,(0,e.eW)(" object, and the "),l,(0,e.eW)(" property of a class.")]),r,(0,e.Lk)("p",null,[(0,e.eW)("At present, the internal mechanisms of the "),i,(0,e.eW)(" decorator must rely on a "),(0,e.Lk)("a",u,[d,(0,e.bF)(s)]),(0,e.eW)(" to associate metadata with the intended class. When the "),(0,e.Lk)("a",k,[(0,e.eW)("Decorator Metadata proposal"),(0,e.bF)(s)]),(0,e.eW)(" becomes more mature and transpilers offer the "),m,(0,e.eW)(" object ("),v,(0,e.eW)("), then this decorator will be updated respectfully to use the available metadata object.")])])}]]);const g=JSON.parse('{"path":"/archive/current/packages/support/meta/tc39.html","title":"TC39 Proposal","lang":"en-GB","frontmatter":{"title":"TC39 Proposal","description":"In relation to TC39 Decorator Metadata proposal","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/meta/tc39.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/toWeakRef.html.4afb7262.js b/assets/js/toWeakRef.html.4afb7262.js
new file mode 100644
index 00000000..6817d670
--- /dev/null
+++ b/assets/js/toWeakRef.html.4afb7262.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[9912],{9904:function(n,a,s){s.r(a),s.d(a,{comp:function(){return u},data:function(){return k}});var e=s(641);const t={id:"toweakref",tabindex:"-1"},o={class:"header-anchor",href:"#toweakref"},p=(0,e.Lk)("code",null,"toWeakRef",-1),c={href:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef",target:"_blank",rel:"noopener noreferrer"},i=(0,e.Lk)("code",null,"WeakRef",-1),l=(0,e.Fv)('
import{ toWeakRef }from"@aedart/support/misc";\n\nconst person ={name:'Sine'};\n\nconst a =toWeakRef(person);// new WeakRef of "person"\nconst b =toWeakRef(a);// same WeakRef instance as "a"\n\ntoWeakRef(null);// undefined\ntoWeakRef(undefined);// undefined\n
',1),r={};var u=(0,s(6262).A)(r,[["render",function(n,a){const s=(0,e.g2)("Badge"),r=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",o,[(0,e.Lk)("span",null,[p,(0,e.eW)(),(0,e.bF)(s,{type:"tip",text:"Available since v0.7",vertical:"middle"})])])]),(0,e.Lk)("p",null,[(0,e.eW)("Wraps a target object into a "),(0,e.Lk)("a",c,[i,(0,e.bF)(r)]),(0,e.eW)(", if not already instance of a weak reference.")]),l])}]]);const k=JSON.parse('{"path":"/archive/current/packages/support/misc/toWeakRef.html","title":"To Weak Ref.","lang":"en-GB","frontmatter":{"title":"To Weak Ref.","description":"Wrap object into a Weak Reference.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/misc/toWeakRef.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/uniqueId.html.7370e18c.js b/assets/js/uniqueId.html.7370e18c.js
new file mode 100644
index 00000000..13464f72
--- /dev/null
+++ b/assets/js/uniqueId.html.7370e18c.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6054],{7717:function(n,s,a){a.r(s),a.d(s,{comp:function(){return k},data:function(){return m}});var e=a(641);const t={id:"uniqueid",tabindex:"-1"},o={class:"header-anchor",href:"#uniqueid"},p=(0,e.Lk)("code",null,"uniqueId",-1),i=(0,e.Fv)('
The uniqueId() is able to return a "unique¹" reference identifier for any given object.
import{ uniqueId, hasUniqueId }from"@aedart/support/objects";\n\nconst target ={\n name:'Ursula'\n};\n\nconsole.log(uniqueId(target));// 27\n\n// ...later in your application\nconsole.log(hasUniqueId(target));// true\nconsole.log(uniqueId(target));// 27\n
',2),c={href:"https://github.com/ngehlert",target:"_blank",rel:"noopener noreferrer"},u={href:"https://developapa.com/object-ids/",target:"_blank",rel:"noopener noreferrer"},l=(0,e.Lk)("em",null,"Get object reference IDs in JavaScript/TypeScript",-1),r=(0,e.Lk)("p",null,[(0,e.eW)("¹: "),(0,e.Lk)("em",null,"In this context, the returned number is unique in the current session. The number will NOT be unique across multiple sessions, nor guarantee that an object will receive the exact same identifier as in a previous session!")],-1),d={};var k=(0,a(6262).A)(d,[["render",function(n,s){const a=(0,e.g2)("Badge"),d=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[(0,e.Lk)("h1",t,[(0,e.Lk)("a",o,[(0,e.Lk)("span",null,[p,(0,e.eW)(),(0,e.bF)(a,{type:"tip",text:"Available since v0.6",vertical:"middle"})])])]),i,(0,e.Lk)("p",null,[(0,e.eW)("The source code is heavily inspired by "),(0,e.Lk)("a",c,[(0,e.eW)("Nicolas Gehlert's"),(0,e.bF)(d)]),(0,e.eW)(" blog post: "),(0,e.Lk)("a",u,[(0,e.eW)('"'),l,(0,e.eW)('" (September 28, 2022)'),(0,e.bF)(d)])]),r])}]]);const m=JSON.parse('{"path":"/archive/current/packages/support/objects/uniqueId.html","title":"Unique ID","lang":"en-GB","frontmatter":{"title":"Unique ID","description":"Set value in object path.","sidebarDepth":0},"headers":[],"git":{"updatedTime":1709288721000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/objects/uniqueId.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/upgrade-guide.html.05a299ae.js b/assets/js/upgrade-guide.html.05a299ae.js
new file mode 100644
index 00000000..f6752b29
--- /dev/null
+++ b/assets/js/upgrade-guide.html.05a299ae.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[5815],{8472:function(n,a,e){e.r(a),e.d(a,{comp:function(){return v},data:function(){return m}});var s=e(641);const t=(0,s.Lk)("h1",{id:"upgrade-guide",tabindex:"-1"},[(0,s.Lk)("a",{class:"header-anchor",href:"#upgrade-guide"},[(0,s.Lk)("span",null,"Upgrade Guide")])],-1),o={class:"table-of-contents"},p=(0,s.Fv)('
The util functions targetMeta() and inheritTargetMeta() now throw a MetaError instead of previous TypeError. If you rely on TypeError as the type of exception being thrown in a try-catch statement, when decorating class members, then you should change it to MetaError.
Various metadata related type definitions have now been deprecated in favour of TypeScript's own definitions. Mostly, this should not affect the implementation. However, if your decorator(s) depend on the following types (see below), then you are strongly encouraged to use corresponding TypeScript defined types instead.
Deprecated types and interfaces are defined in @aedart/contracts/support/meta:
ClassContext
MethodContext
GetterContext
SetterContext
FieldContext
AccessorContext
MetadataContext
MemberContext
More information available in the source code and CHANGELOG.md
The @aedart/vuepress-utils has been upgraded to use vuepress v2.0.0-rc.2, meaning that you no longer should require to manually define your vuepress dependency, in your application's packages.json file.
forgetAll(), hasAll() and hasAny() (in @aedart/support/object submodule) now accept rest parameters instead of an array of paths. If you are using these methods, then you need to upgrade or risk unexpected results.
',10),u={href:"https://github.com/aedart/ion/blob/main/CHANGELOG.md",target:"_blank",rel:"noopener noreferrer"},k={};var v=(0,e(6262).A)(k,[["render",function(n,a){const e=(0,s.g2)("router-link"),k=(0,s.g2)("ExternalLinkIcon");return(0,s.uX)(),(0,s.CE)("div",null,[t,(0,s.Lk)("nav",o,[(0,s.Lk)("ul",null,[(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#from-v0-7-x-to-v0-10-x"},{default:(0,s.k6)((()=>[(0,s.eW)("From v0.7.x- to v0.10.x")])),_:1}),(0,s.Lk)("ul",null,[(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#meta-types"},{default:(0,s.k6)((()=>[(0,s.eW)("Meta (types)")])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#meta-targetmeta-and-inherittargetmeta"},{default:(0,s.k6)((()=>[(0,s.eW)("Meta (targetMeta() and inheritTargetMeta())")])),_:1})])])]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#from-v0-6-x-to-v0-7-x"},{default:(0,s.k6)((()=>[(0,s.eW)("From v0.6.x to v0.7.x")])),_:1}),(0,s.Lk)("ul",null,[(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#node-js-20-11-0-required"},{default:(0,s.k6)((()=>[(0,s.eW)("Node.js 20.11.0 Required")])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#meta"},{default:(0,s.k6)((()=>[(0,s.eW)("Meta")])),_:1})]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#vuepress-utils"},{default:(0,s.k6)((()=>[(0,s.eW)("Vuepress Utils")])),_:1})])])]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#from-v0-3-x-to-v0-4-x"},{default:(0,s.k6)((()=>[(0,s.eW)("From v0.3.x to v0.4.x")])),_:1}),(0,s.Lk)("ul",null,[(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#rest-parameters-for-forgetall-hasall-and-hasany"},{default:(0,s.k6)((()=>[(0,s.eW)("Rest Parameters for forgetAll(), hasAll() and hasAny()")])),_:1})])])]),(0,s.Lk)("li",null,[(0,s.bF)(e,{to:"#onward"},{default:(0,s.k6)((()=>[(0,s.eW)("Onward")])),_:1})])])]),p,(0,s.Lk)("p",null,[(0,s.eW)("Ion now requires "),(0,s.Lk)("a",l,[(0,s.eW)("Node.js"),(0,s.bF)(k)]),(0,s.eW)(),r,(0,s.eW)(" or greater.")]),i,(0,s.Lk)("p",null,[(0,s.eW)("Please read "),(0,s.Lk)("a",c,[(0,s.eW)("vuepress' changelog"),(0,s.bF)(k)]),(0,s.eW)(" for additional details.")]),d,(0,s.Lk)("p",null,[(0,s.eW)("More details can be found in the "),(0,s.Lk)("a",u,[(0,s.eW)("changelog"),(0,s.bF)(k)]),(0,s.eW)(".")])])}]]);const m=JSON.parse('{"path":"/archive/current/upgrade-guide.html","title":"Upgrade Guide","lang":"en-GB","frontmatter":{"description":"Ion Upgrade Guide","sidebarDepth":1},"headers":[{"level":2,"title":"From v0.7.x- to v0.10.x","slug":"from-v0-7-x-to-v0-10-x","link":"#from-v0-7-x-to-v0-10-x","children":[{"level":3,"title":"Meta (types)","slug":"meta-types","link":"#meta-types","children":[]},{"level":3,"title":"Meta (targetMeta() and inheritTargetMeta())","slug":"meta-targetmeta-and-inherittargetmeta","link":"#meta-targetmeta-and-inherittargetmeta","children":[]}]},{"level":2,"title":"From v0.6.x to v0.7.x","slug":"from-v0-6-x-to-v0-7-x","link":"#from-v0-6-x-to-v0-7-x","children":[{"level":3,"title":"Node.js 20.11.0 Required","slug":"node-js-20-11-0-required","link":"#node-js-20-11-0-required","children":[]},{"level":3,"title":"Meta","slug":"meta","link":"#meta","children":[]},{"level":3,"title":"Vuepress Utils","slug":"vuepress-utils","link":"#vuepress-utils","children":[]}]},{"level":2,"title":"From v0.3.x to v0.4.x","slug":"from-v0-3-x-to-v0-4-x","link":"#from-v0-3-x-to-v0-4-x","children":[{"level":3,"title":"Rest Parameters for forgetAll(), hasAll() and hasAny()","slug":"rest-parameters-for-forgetall-hasall-and-hasany","link":"#rest-parameters-for-forgetall-hasall-and-hasany","children":[]}]},{"level":2,"title":"Onward","slug":"onward","link":"#onward","children":[]}],"git":{"updatedTime":1709813341000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":3},{"name":"alin","email":"alin@rspsystems.com","commits":3}]},"filePathRelative":"archive/current/upgrade-guide.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/usage.html.740ce24f.js b/assets/js/usage.html.740ce24f.js
new file mode 100644
index 00000000..3ef21253
--- /dev/null
+++ b/assets/js/usage.html.740ce24f.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6333],{3623:function(n,s,a){a.r(s),a.d(s,{comp:function(){return f},data:function(){return C}});var e=a(641);const t=(0,e.Lk)("h1",{id:"how-to-use-concerns",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#how-to-use-concerns"},[(0,e.Lk)("span",null,"How to use Concerns")])],-1),c={class:"table-of-contents"},o=(0,e.Lk)("h2",{id:"using-concerns",tabindex:"-1"},[(0,e.Lk)("a",{class:"header-anchor",href:"#using-concerns"},[(0,e.Lk)("span",null,"Using Concerns")])],-1),i={href:"https://github.com/tc39/proposal-decorators",target:"_blank",rel:"noopener noreferrer"},p=(0,e.Lk)("code",null,"use()",-1),l=(0,e.Fv)('
import{ use }from"@aedart/support/concerns";\n\n@use(\n ApiConnection,\n Serialization,\n Collections\n)\nclassFlight{}\n
You can achieve the same result by using the getContainer() utility method.
import{ use, getContainer }from"@aedart/support/concerns";\n\n// ...Encryption concern not shown...\n\n@use(Encryption)\nclassCookieStore{\n constructor(){\n const value =getContainer(this)\n .get(Encryption)\n .encrypt('Lorum lipsum');\n \n // ...remaining not shown...\n }\n}\n
CONCERNS symbol, getContainer(), and getConcernsContainer()
There are 3 ways to obtain the concerns container instance:
A) CONCERNS symbol
Inside your target class, if you know that concerns are used (if target is a "concern owner"), then you can use the CONCERNS symbol to gain access to the container.
import{CONCERNS}from"@aedart/support/concerns";\n\n// Inside your target class...\nconst container =this[CONCERNS];\n
B) getContainer()
getContainer() is essentially a just a wrapper for: return this[CONCERNS].
import{ getContainer }from"@aedart/support/concerns";\n\n// Inside your target class...\nconst container =getContainer(this);\n
C) getConcernsContainer()
The getConcernsContainer() achieves the same result as the previous shown methods. However, it does perform a check of the provided target instance, which ensures that it is a "concern owner". If the target does not pass this test, then a TypeError is thrown. This might can be useful in situations when you might now know if the target is a concern owner, e.g. when situated in a child class or outside a target class.
import{ getConcernsContainer }from"@aedart/support/concerns";\n\n// Inside your target class...\nconst container =getConcernsContainer(this);\n
',8),y={};var f=(0,a(6262).A)(y,[["render",function(n,s){const a=(0,e.g2)("router-link"),y=(0,e.g2)("ExternalLinkIcon"),f=(0,e.g2)("RouteLink");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("nav",c,[(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#using-concerns"},{default:(0,e.k6)((()=>[(0,e.eW)("Using Concerns")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#inheritance"},{default:(0,e.k6)((()=>[(0,e.eW)("Inheritance")])),_:1})]),(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#manual-interaction"},{default:(0,e.k6)((()=>[(0,e.eW)("Manual interaction")])),_:1}),(0,e.Lk)("ul",null,[(0,e.Lk)("li",null,[(0,e.bF)(a,{to:"#determine-if-target-uses-concerns"},{default:(0,e.k6)((()=>[(0,e.eW)("Determine if target uses concerns")])),_:1})])])])])]),o,(0,e.Lk)("p",null,[(0,e.eW)("The "),(0,e.Lk)("a",i,[(0,e.eW)("class decorator"),(0,e.bF)(y)]),(0,e.eW)(),p,(0,e.eW)(" is used to inject one or more concern classes into a target class.")]),l,(0,e.Lk)("p",null,[(0,e.eW)("When concern classes are injected, the target class is transformed and all concerns are made available inside a private "),u,(0,e.eW)(" property. See "),r,(0,e.eW)(" and "),(0,e.bF)(f,{to:"/archive/current/packages/support/concerns/aliases.html"},{default:(0,e.k6)((()=>[(0,e.eW)("Aliases")])),_:1}),(0,e.eW)(" for additional details.")]),d,(0,e.Lk)("div",k,[v,(0,e.Lk)("p",null,[(0,e.eW)("See also "),(0,e.bF)(f,{to:"/archive/current/packages/support/concerns/conflictResolution.html"},{default:(0,e.k6)((()=>[(0,e.eW)("Conflict Resolution")])),_:1}),(0,e.eW)(" for additional details.")])]),m,(0,e.Lk)("p",null,[(0,e.eW)('When concerns are injected into a target, they are defined inside a "Concerns Container", which is available in the target instance via the '),b,(0,e.eW)(" symbol. Should you require to perform more advanced interaction with a concern class instance, then you can obtain a concern instance via the container's "),g,(0,e.eW)(" method. It will automatically ensure to "),(0,e.bF)(f,{to:"/archive/current/packages/support/concerns/booting.html"},{default:(0,e.k6)((()=>[(0,e.eW)("boot")])),_:1}),(0,e.eW)(" a concern, if not already booted.")]),h])}]]);const C=JSON.parse('{"path":"/archive/current/packages/support/concerns/usage.html","title":"Using Concerns","lang":"en-GB","frontmatter":{"title":"Using Concerns","description":"How to use concerns.","sidebarDepth":0},"headers":[{"level":2,"title":"Using Concerns","slug":"using-concerns","link":"#using-concerns","children":[]},{"level":2,"title":"Inheritance","slug":"inheritance","link":"#inheritance","children":[]},{"level":2,"title":"Manual interaction","slug":"manual-interaction","link":"#manual-interaction","children":[{"level":3,"title":"Determine if target uses concerns","slug":"determine-if-target-uses-concerns","link":"#determine-if-target-uses-concerns","children":[]}]}],"git":{"updatedTime":1709641376000,"contributors":[{"name":"alin","email":"alin@rspsystems.com","commits":1}]},"filePathRelative":"archive/current/packages/support/concerns/usage.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/assets/js/version-disclaimer.html.b653dfc9.js b/assets/js/version-disclaimer.html.b653dfc9.js
new file mode 100644
index 00000000..6567418b
--- /dev/null
+++ b/assets/js/version-disclaimer.html.b653dfc9.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_aedart_ion_monorepo=self.webpackChunk_aedart_ion_monorepo||[]).push([[6368],{6679:function(n,a,s){s.r(a),s.d(a,{comp:function(){return h},data:function(){return f}});var e=s(641);const t=(0,e.Fv)('
The <VersionDisclaimer /> component is a simply "notice" container, which can be used in your layout. Most often, you would use this to display a custom message when outdated / unsupported documentation is being viewed.
<VersionDisclaimertype="warning"label="Note">\n You are viewing documentation for an unsupported version...\n</VersionDisclaimer>\n
',1),g={};var h=(0,s(6262).A)(g,[["render",function(n,a){const s=(0,e.g2)("RouteLink"),g=(0,e.g2)("ExternalLinkIcon");return(0,e.uX)(),(0,e.CE)("div",null,[t,(0,e.Lk)("p",null,[(0,e.eW)("The following example assumes that you are using an "),(0,e.bF)(s,{to:"/archive/current/packages/vuepress-utils/navigation/archive.html"},{default:(0,e.k6)((()=>[o,(0,e.eW)(" component")])),_:1}),(0,e.eW)(' to structure documentation. When doing so, you can display a custom message whenever "outdated" or "upcoming" documentation is being viewed.')]),(0,e.Lk)("p",null,[(0,e.eW)("To achieve this, you will need to create a "),(0,e.Lk)("a",p,[(0,e.eW)("custom layout"),(0,e.bF)(g)]),(0,e.eW)(" ("),i,(0,e.eW)("). Create a new layout, e.g. in "),l,(0,e.eW)(".")]),c,(0,e.Lk)("p",null,[(0,e.eW)("The "),u,(0,e.eW)(" method returns a computed property that indicates if visitor is viewing the "),(0,e.bF)(s,{to:"/archive/current/packages/vuepress-utils/navigation/archive.html#current--next"},{default:(0,e.k6)((()=>[(0,e.eW)('"next" collection of pages')])),_:1}),(0,e.eW)(". The "),r,(0,e.eW)(' methods returns a computed property that determines if pages are viewed that do not belong to "next" nor "current" collections.')]),d,(0,e.Lk)("p",null,[(0,e.eW)("In your "),(0,e.Lk)("a",k,[(0,e.eW)("Client Config File"),(0,e.bF)(g)]),(0,e.eW)(", use the custom "),v,(0,e.eW)(".")]),m])}]]);const f=JSON.parse('{"path":"/archive/current/packages/vuepress-utils/components/version-disclaimer.html","title":"Version Disclaimer","lang":"en-GB","frontmatter":{"title":"Version Disclaimer","description":"A simple notice container","sidebarDepth":0},"headers":[{"level":2,"title":"Properties","slug":"properties","link":"#properties","children":[{"level":3,"title":"type (optional)","slug":"type-optional","link":"#type-optional","children":[]},{"level":3,"title":"label (optional)","slug":"label-optional","link":"#label-optional","children":[]}]},{"level":2,"title":"Extend Default Layout","slug":"extend-default-layout","link":"#extend-default-layout","children":[]},{"level":2,"title":"Client Config","slug":"client-config","link":"#client-config","children":[]}],"git":{"updatedTime":1679769520000,"contributors":[{"name":"Alin Eugen Deac","email":"aedart@gmail.com","commits":1}]},"filePathRelative":"archive/current/packages/vuepress-utils/components/version-disclaimer.md","lastUpdatedDateFormat":"yyyy-MM-dd HH:mm:ss ZZZZ","lastUpdatedDateOptions":{}}')}}]);
\ No newline at end of file
diff --git a/favicon.ico b/favicon.ico
new file mode 100644
index 00000000..8bbf645e
Binary files /dev/null and b/favicon.ico differ
diff --git a/images/icon/README.md b/images/icon/README.md
new file mode 100644
index 00000000..6f7d2cb2
--- /dev/null
+++ b/images/icon/README.md
@@ -0,0 +1,4 @@
+# About Ion Icon
+
+The icon was generated using [favicon.io](https://favicon.io/favicon-generator/).
+See details in [about](about.txt).
diff --git a/images/icon/about.txt b/images/icon/about.txt
new file mode 100644
index 00000000..7d6aedf6
--- /dev/null
+++ b/images/icon/about.txt
@@ -0,0 +1,6 @@
+This favicon was generated using the following font:
+
+- Font Title: Leckerli One
+- Font Author: Copyright (c) 2011 Gesine Todt (www.gesine-todt.de), with Reserved Font Names "Leckerli"
+- Font Source: http://fonts.gstatic.com/s/leckerlione/v16/V8mCoQH8VCsNttEnxnGQ-1itLZxcBtItFw.ttf
+- Font License: SIL Open Font License, 1.1 (http://scripts.sil.org/OFL))
diff --git a/images/icon/android-chrome-192x192.png b/images/icon/android-chrome-192x192.png
new file mode 100644
index 00000000..a1405ac4
Binary files /dev/null and b/images/icon/android-chrome-192x192.png differ
diff --git a/images/icon/android-chrome-512x512.png b/images/icon/android-chrome-512x512.png
new file mode 100644
index 00000000..e3d0ea11
Binary files /dev/null and b/images/icon/android-chrome-512x512.png differ
diff --git a/images/icon/apple-touch-icon.png b/images/icon/apple-touch-icon.png
new file mode 100644
index 00000000..4dc18c75
Binary files /dev/null and b/images/icon/apple-touch-icon.png differ
diff --git a/images/icon/favicon-16x16.png b/images/icon/favicon-16x16.png
new file mode 100644
index 00000000..8dc03ca1
Binary files /dev/null and b/images/icon/favicon-16x16.png differ
diff --git a/images/icon/favicon-32x32.png b/images/icon/favicon-32x32.png
new file mode 100644
index 00000000..4ca10cc3
Binary files /dev/null and b/images/icon/favicon-32x32.png differ
diff --git a/index.html b/index.html
new file mode 100644
index 00000000..fce196c2
--- /dev/null
+++ b/index.html
@@ -0,0 +1,37 @@
+
+
+
+
+
+
+
+
+ Ion
+
+
+
+
+
+
