You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@royale.apache.org by Yishay Weiss <yi...@hotmail.com> on 2020/01/12 15:29:50 UTC

YFiles, EPL, Apache

Hi,

Before I start making inquiries in legal I wonder if anyone here can give me some guidance.

I want to create typedefs for yFiles [1], using an externs [2] file that’s under an EPL [3]. Should that be a problem?

This issue [4] makes me extra cautious.

Thanks.

[1] https://www.yworks.com/products/yfiles-for-html
[2] https://raw.githubusercontent.com/honzabrecka/ts-to-goog/master/externs/yfiles.extern.js
[3] https://github.com/honzabrecka/ts-to-goog/blob/master/LICENSE
[4] https://github.com/DefinitelyTyped/DefinitelyTyped/issues/23310

Re: YFiles, EPL, Apache

Posted by Yishay Weiss <yi...@hotmail.com>.
Turns out I suddenly can't use my default mail client which declares Content-Type: text/html;

Anyway, here goes yet another attempt to reply:

This [1] is what Josh wrote on pain points.

[1] http://apache-royale-development.20373.n8.nabble.com/NextGenAS-tutorials-on-Royale-website-tp6582p6686.html
Apache Royale Development - NextGenAS tutorials on Royale website<http://apache-royale-development.20373.n8.nabble.com/NextGenAS-tutorials-on-Royale-website-tp6582p6686.html>
NextGenAS tutorials on Royale website. Hi, I contacted today Josh Tynjala, looking for the NodeJS tutorial he did that I could not find. It seems he refactored his site and change domain and the...
apache-royale-development.20373.n8.nabble.com


________________________________
From: Alex Harui <ah...@adobe.com.INVALID>
Sent: Wednesday, February 5, 2020 8:23 AM
To: dev@royale.apache.org <de...@royale.apache.org>
Cc: sebastian.mueller@yworks.com <se...@yworks.com>
Subject: Re: YFiles, EPL, Apache

Sebastian wrote to the list.  He was having trouble responding because Apache is blocking incoming emails from Nabble these days.

Sebastian is encouraging us to take over maintenance of the d.ts converter as the .d.ts file might contain more useful information than the JS file.  He also explained the format of the JS file.  He doesn't seem interested in generating a parse-able JS file and drawing in the Google Closure Compiler users base at this time.

I don't remember what the pain points of the d.ts converter were.  I believe it would be easier to write a utility that flips the order of APIs in the JS file to see if the result would be a valid Google Closure Externs file.  But he is right that being able to consume d.ts files would be much more general purpose.

-Alex

On 2/5/20, 12:06 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    You’re right about yfiles being the only one needing a var prefix. I sent a more detailed response, but my mails are getting bounced from the list for some reason. Will try to work privately with Sebastian on this.

    From: Alex Harui<ma...@adobe.com.INVALID>
    Sent: Tuesday, February 4, 2020 7:33 PM
    To: dev@royale.apache.org<ma...@royale.apache.org>; Alex Harui<ma...@adobe.com.INVALID>
    Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
    Subject: Re: YFiles, EPL, Apache

    Looking more carefully at the file, I think the warning you posted should be the only one like that.  Aren't you getting other errors for some of the classes?

    I don't know if Sebastian is still following this discussion, but it looks like with a few changes, that file could be a valid Google Closure Externs file and would then open up use of YFiles for folks who use the Google Closure Compiler, which would hopefully be a significant market for them.

    Yishay, if you have time you can either manually manipulate that file and get it to parse cleanly or write a tool that does it.  I think you first have to change:

    /**
     * @namespace
     */
    yfiles={};

    To:

    /**
     * @namespace
     * @const
     */
    var yfiles={};

    Then find places where class members are defined before the class constructor and change the order.  So I saw that their Map class constructor is on line 51, after the first Map member definition on line 22.  Move line 51 with its JSDoc before line 22's JSDoc and see if the warning goes away and the Map class is generated.

    If you write a tool, it could just for a.b.c.x being defined before a.b.c.

    HTH,
    -Alex

    On 2/4/20, 7:18 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

        The interfaces seem to be generated ok, but not classes. I’m getting warnings such as

             [java] WARNING: [yfiles]:14: WARNING - accessing name yfiles in externs has no effect. Perhaps you forgot to add a var keyword?
             [java] yfiles={};
             [java] ^^^^^^

        From: Alex Harui<ma...@adobe.com.INVALID>
        Sent: Tuesday, February 4, 2020 6:33 AM
        To: dev@royale.apache.org<ma...@royale.apache.org>; Alex Harui<ma...@adobe.com.INVALID>
        Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
        Subject: Re: YFiles, EPL, Apache

        Yishay,

        Did you try to run this file through the Royale Externs Compiler?  It looks a lot like Google Closure Externs format to me.  You might get lucky and it will  "just work" or there will be errors and we can discuss whether YFiles wants to have a file that can be directly used by the Google Closure Compiler or not.

        -Alex

        On 2/3/20, 7:02 PM, "Alex Harui" <ah...@adobe.com.INVALID> wrote:

            Is this JSDoc file on the internet so I can take a look?

            The Royale Externs Compiler uses Google Closure's JavaScript parser because externs/typedefs are supposed to be a specially-formatted but valid JavaScript, so an AST (different from the one that we generate from MXML/AS) can be created from Closure-compatible JavaScript.  It may be possible/better to work from the Closure AST in this case.

            HTH,
            -Alex

            On 2/3/20, 6:57 PM, "Yishay Weiss" <yi...@hotmail.com> wrote:

                Yes, they do have a jsdoc file. Do you think it would be easier to maintain a conversion tool for that?
                ________________________________
                From: Alex Harui <ah...@adobe.com.INVALID>
                Sent: Monday, February 3, 2020 8:54:00 PM
                To: dev@royale.apache.org <de...@royale.apache.org>
                Cc: sebastian.mueller@yworks.com <se...@yworks.com>
                Subject: Re: YFiles, EPL, Apache

                I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.

                -Alex

                On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

                    Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.

                    [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623434558&amp;sdata=MZ9xPXp5DDU5z11JTO67hcYFUocOs8hES03Qmpx04XQ%3D&amp;reserved=0
                    [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623434558&amp;sdata=MPyhTOdGFngnEC0UFXnNRMRhR5EjvekX2laq0lSBBME%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623434558&amp;sdata=MZ9xPXp5DDU5z11JTO67hcYFUocOs8hES03Qmpx04XQ%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=wHz1Pm%2B5GyRNCwCn3xwqDufUlkGp93bBFjF%2BVgvj16o%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=wHz1Pm%2B5GyRNCwCn3xwqDufUlkGp93bBFjF%2BVgvj16o%3D&amp;reserved=0>>>
                    GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=dJMOD2qP33vtLCCmBLSu88zfFTpfnzs3XpoaynHhiD8%3D&amp;reserved=0>
                    Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
                    github.com

                    ________________________________
                    From: Alex Harui <ah...@adobe.com.INVALID>
                    Sent: Monday, February 3, 2020 4:40 PM
                    To: dev@royale.apache.org <de...@royale.apache.org>
                    Cc: sebastian.mueller@yworks.com <se...@yworks.com>
                    Subject: Re: YFiles, EPL, Apache

                    I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.

                    -Alex

                    On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

                        Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.

                        [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=opYbu%2FZi5FNTCglbo3MIpBTl62%2F%2FW%2FgmStv2XD%2FMn4w%3D&amp;reserved=0
                        [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=E0d6LZikH4bkEZhyzuUrQEctIgjReFC%2FV3T3YkdH4Q4%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=4Oo1A%2BBuayM%2BqRGZFOfIOXGNx2TJz5Sjw6v3SvksJg4%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=E0d6LZikH4bkEZhyzuUrQEctIgjReFC%2FV3T3YkdH4Q4%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=E0d6LZikH4bkEZhyzuUrQEctIgjReFC%2FV3T3YkdH4Q4%3D&amp;reserved=0>>>
                        [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=iOtFoyOQmysldJKNTUeIw4AXNLXcHMTMvfvV%2FNOA9Eg%3D&amp;reserved=0

                        From: Yishay Weiss<ma...@hotmail.com>
                        Sent: Monday, February 3, 2020 2:57 PM
                        To: dev@royale.apache.org<ma...@royale.apache.org>
                        Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
                        Subject: RE: YFiles, EPL, Apache

                        As promised, here is the summary of my correspondence with yFiles.

                        > My questions to Sebastian from yWorks:
                        >
                        > a) Would yWorks allow us to create and publish typedefs (think of them
                        > as Royale d.ts files) in our GitHub repository? I would also need to
                        > check license issues on the Apache side.

                        Our license does not allow publishing such files, which would be
                        derivative works from files which are currently under our proprietary
                        license. Although we could grant you permission to do that, we are
                        currently very hesitant to do so. Here's why: Unless there is someone
                        who actively maintains these typings, they would quickly become outdated
                        because with every new release we add new features and APIs. The only
                        way someone could reasonably maintain such a file (about 10k public API
                        members, 7 MB TypeScript definition file) would be through a
                        (semi-automatic?) conversion process. Thus both from a practical and
                        legal perspective it would make a lot more sense to have a tool that
                        reads our API definition files and creates the typedefs. Any licensed
                        yFiles user could make use of this tool and would always get the
                        typedefs matching her yFiles version.

                        For you reference: This is what someone else did to get yFiles for HTML
                        to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=qll5kKxd3lInepBL54sqotRwwzcSVThJc%2F48N9IwylA%3D&amp;reserved=0
                        They got explicit permission from us for this (because they do not
                        publish the original files).

                        >
                        > b) Would yWorks consider porting yFiles to Royale?

                        Yes, if and once we get reasonable amount of feedback and customer
                        interest. If you're interested in licensing yFiles for Apache Royale,
                        please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=n4p4VsZMPFrM1K6PMpq6BJvjpYxrILtilBRoBVSqrZY%3D&amp;reserved=0>
                        FWIW the vast majoriy of our previous yFiles FLEX customers has
                        successfully migrated to "native web" technologies and is now happily
                        using yFiles for HTML: With the current state of Apache Royale and the
                        web, we don't see that Apache Royale has gained enough traction that
                        would justify the efforts.
                        We currently believe that creating the diagramming part using "classic"
                        TypeScript/JavaScript and wrapping the resulting component up in a small
                        Royale component with a tiny API surface is the superios and more
                        efficient approach.


                        From: Yishay Weiss<ma...@hotmail.com>
                        Sent: Sunday, January 12, 2020 11:37 PM
                        To: dev@royale.apache.org<ma...@royale.apache.org>
                        Subject: RE: YFiles, EPL, Apache

                        Ok, I contacted them. I’ll let you guys know.

                        ________________________________
                        From: Carlos Rovira <ca...@apache.org>
                        Sent: Sunday, January 12, 2020 6:58:17 PM
                        To: dev@royale.apache.org <de...@royale.apache.org>
                        Subject: Re: YFiles, EPL, Apache

                        Hi,

                        I think you should contact yFiles directly and talk with them about it.
                        That's better to try to figure if something could be wrong in the future.

                        My understanding is that he should be able to give you permission since it
                        implies make his commercial lib to clients that want to use in Royale.
                        So that clientes will still need to pay for the commercial version, while
                        if no typedefs are done, it will be more difficult to do.



                        El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
                        escribió:

                        >
                        > Hi,
                        >
                        > Before I start making inquiries in legal I wonder if anyone here can give
                        > me some guidance.
                        >
                        > I want to create typedefs for yFiles [1], using an externs [2] file that’s
                        > under an EPL [3]. Should that be a problem?
                        >
                        > This issue [4] makes me extra cautious.
                        >
                        > Thanks.
                        >
                        > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=slXu8Ddrx%2FJ6wLBPmzzXTyl9fLlPfZFAK97rB7LGEfA%3D&amp;reserved=0
                        > [2]
                        > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=g%2FINc05LaGKDnWYFa1hnWtfXh52VBnD76Zs8Vampf0U%3D&amp;reserved=0
                        > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=vd9zuLouHhMI%2ByovqI4Uy%2FqNgtegO8%2FaQ%2FhZnI4SeMw%3D&amp;reserved=0
                        > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=psvygNG2%2F%2F5IlP49G0sUOc2%2BNRaNR9mHaGDaLdbWWFY%3D&amp;reserved=0
                        >


                        --
                        Carlos Rovira
                        https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=j5YsKuAXvyFTDjRcgsOp1ksLCfZQ42BhcSXvYvtdnZo%3D&amp;reserved=0














Re: YFiles, EPL, Apache

Posted by Alex Harui <ah...@adobe.com.INVALID>.
Sebastian wrote to the list.  He was having trouble responding because Apache is blocking incoming emails from Nabble these days.

Sebastian is encouraging us to take over maintenance of the d.ts converter as the .d.ts file might contain more useful information than the JS file.  He also explained the format of the JS file.  He doesn't seem interested in generating a parse-able JS file and drawing in the Google Closure Compiler users base at this time.

I don't remember what the pain points of the d.ts converter were.  I believe it would be easier to write a utility that flips the order of APIs in the JS file to see if the result would be a valid Google Closure Externs file.  But he is right that being able to consume d.ts files would be much more general purpose.

-Alex

On 2/5/20, 12:06 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    You’re right about yfiles being the only one needing a var prefix. I sent a more detailed response, but my mails are getting bounced from the list for some reason. Will try to work privately with Sebastian on this.
    
    From: Alex Harui<ma...@adobe.com.INVALID>
    Sent: Tuesday, February 4, 2020 7:33 PM
    To: dev@royale.apache.org<ma...@royale.apache.org>; Alex Harui<ma...@adobe.com.INVALID>
    Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
    Subject: Re: YFiles, EPL, Apache
    
    Looking more carefully at the file, I think the warning you posted should be the only one like that.  Aren't you getting other errors for some of the classes?
    
    I don't know if Sebastian is still following this discussion, but it looks like with a few changes, that file could be a valid Google Closure Externs file and would then open up use of YFiles for folks who use the Google Closure Compiler, which would hopefully be a significant market for them.
    
    Yishay, if you have time you can either manually manipulate that file and get it to parse cleanly or write a tool that does it.  I think you first have to change:
    
    /**
     * @namespace
     */
    yfiles={};
    
    To:
    
    /**
     * @namespace
     * @const
     */
    var yfiles={};
    
    Then find places where class members are defined before the class constructor and change the order.  So I saw that their Map class constructor is on line 51, after the first Map member definition on line 22.  Move line 51 with its JSDoc before line 22's JSDoc and see if the warning goes away and the Map class is generated.
    
    If you write a tool, it could just for a.b.c.x being defined before a.b.c.
    
    HTH,
    -Alex
    
    On 2/4/20, 7:18 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
        The interfaces seem to be generated ok, but not classes. I’m getting warnings such as
    
             [java] WARNING: [yfiles]:14: WARNING - accessing name yfiles in externs has no effect. Perhaps you forgot to add a var keyword?
             [java] yfiles={};
             [java] ^^^^^^
    
        From: Alex Harui<ma...@adobe.com.INVALID>
        Sent: Tuesday, February 4, 2020 6:33 AM
        To: dev@royale.apache.org<ma...@royale.apache.org>; Alex Harui<ma...@adobe.com.INVALID>
        Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
        Subject: Re: YFiles, EPL, Apache
    
        Yishay,
    
        Did you try to run this file through the Royale Externs Compiler?  It looks a lot like Google Closure Externs format to me.  You might get lucky and it will  "just work" or there will be errors and we can discuss whether YFiles wants to have a file that can be directly used by the Google Closure Compiler or not.
    
        -Alex
    
        On 2/3/20, 7:02 PM, "Alex Harui" <ah...@adobe.com.INVALID> wrote:
    
            Is this JSDoc file on the internet so I can take a look?
    
            The Royale Externs Compiler uses Google Closure's JavaScript parser because externs/typedefs are supposed to be a specially-formatted but valid JavaScript, so an AST (different from the one that we generate from MXML/AS) can be created from Closure-compatible JavaScript.  It may be possible/better to work from the Closure AST in this case.
    
            HTH,
            -Alex
    
            On 2/3/20, 6:57 PM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
                Yes, they do have a jsdoc file. Do you think it would be easier to maintain a conversion tool for that?
                ________________________________
                From: Alex Harui <ah...@adobe.com.INVALID>
                Sent: Monday, February 3, 2020 8:54:00 PM
                To: dev@royale.apache.org <de...@royale.apache.org>
                Cc: sebastian.mueller@yworks.com <se...@yworks.com>
                Subject: Re: YFiles, EPL, Apache
    
                I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.
    
                -Alex
    
                On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
                    Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.
    
                    [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623434558&amp;sdata=MZ9xPXp5DDU5z11JTO67hcYFUocOs8hES03Qmpx04XQ%3D&amp;reserved=0
                    [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623434558&amp;sdata=MPyhTOdGFngnEC0UFXnNRMRhR5EjvekX2laq0lSBBME%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623434558&amp;sdata=MZ9xPXp5DDU5z11JTO67hcYFUocOs8hES03Qmpx04XQ%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=wHz1Pm%2B5GyRNCwCn3xwqDufUlkGp93bBFjF%2BVgvj16o%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=wHz1Pm%2B5GyRNCwCn3xwqDufUlkGp93bBFjF%2BVgvj16o%3D&amp;reserved=0>>>
                    GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=dJMOD2qP33vtLCCmBLSu88zfFTpfnzs3XpoaynHhiD8%3D&amp;reserved=0>
                    Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
                    github.com
    
                    ________________________________
                    From: Alex Harui <ah...@adobe.com.INVALID>
                    Sent: Monday, February 3, 2020 4:40 PM
                    To: dev@royale.apache.org <de...@royale.apache.org>
                    Cc: sebastian.mueller@yworks.com <se...@yworks.com>
                    Subject: Re: YFiles, EPL, Apache
    
                    I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.
    
                    -Alex
    
                    On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
                        Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.
    
                        [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=opYbu%2FZi5FNTCglbo3MIpBTl62%2F%2FW%2FgmStv2XD%2FMn4w%3D&amp;reserved=0
                        [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=E0d6LZikH4bkEZhyzuUrQEctIgjReFC%2FV3T3YkdH4Q4%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=4Oo1A%2BBuayM%2BqRGZFOfIOXGNx2TJz5Sjw6v3SvksJg4%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=E0d6LZikH4bkEZhyzuUrQEctIgjReFC%2FV3T3YkdH4Q4%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=E0d6LZikH4bkEZhyzuUrQEctIgjReFC%2FV3T3YkdH4Q4%3D&amp;reserved=0>>>
                        [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=iOtFoyOQmysldJKNTUeIw4AXNLXcHMTMvfvV%2FNOA9Eg%3D&amp;reserved=0
    
                        From: Yishay Weiss<ma...@hotmail.com>
                        Sent: Monday, February 3, 2020 2:57 PM
                        To: dev@royale.apache.org<ma...@royale.apache.org>
                        Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
                        Subject: RE: YFiles, EPL, Apache
    
                        As promised, here is the summary of my correspondence with yFiles.
    
                        > My questions to Sebastian from yWorks:
                        >
                        > a) Would yWorks allow us to create and publish typedefs (think of them
                        > as Royale d.ts files) in our GitHub repository? I would also need to
                        > check license issues on the Apache side.
    
                        Our license does not allow publishing such files, which would be
                        derivative works from files which are currently under our proprietary
                        license. Although we could grant you permission to do that, we are
                        currently very hesitant to do so. Here's why: Unless there is someone
                        who actively maintains these typings, they would quickly become outdated
                        because with every new release we add new features and APIs. The only
                        way someone could reasonably maintain such a file (about 10k public API
                        members, 7 MB TypeScript definition file) would be through a
                        (semi-automatic?) conversion process. Thus both from a practical and
                        legal perspective it would make a lot more sense to have a tool that
                        reads our API definition files and creates the typedefs. Any licensed
                        yFiles user could make use of this tool and would always get the
                        typedefs matching her yFiles version.
    
                        For you reference: This is what someone else did to get yFiles for HTML
                        to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=qll5kKxd3lInepBL54sqotRwwzcSVThJc%2F48N9IwylA%3D&amp;reserved=0
                        They got explicit permission from us for this (because they do not
                        publish the original files).
    
                        >
                        > b) Would yWorks consider porting yFiles to Royale?
    
                        Yes, if and once we get reasonable amount of feedback and customer
                        interest. If you're interested in licensing yFiles for Apache Royale,
                        please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623444514&amp;sdata=n4p4VsZMPFrM1K6PMpq6BJvjpYxrILtilBRoBVSqrZY%3D&amp;reserved=0>
                        FWIW the vast majoriy of our previous yFiles FLEX customers has
                        successfully migrated to "native web" technologies and is now happily
                        using yFiles for HTML: With the current state of Apache Royale and the
                        web, we don't see that Apache Royale has gained enough traction that
                        would justify the efforts.
                        We currently believe that creating the diagramming part using "classic"
                        TypeScript/JavaScript and wrapping the resulting component up in a small
                        Royale component with a tiny API surface is the superios and more
                        efficient approach.
    
    
                        From: Yishay Weiss<ma...@hotmail.com>
                        Sent: Sunday, January 12, 2020 11:37 PM
                        To: dev@royale.apache.org<ma...@royale.apache.org>
                        Subject: RE: YFiles, EPL, Apache
    
                        Ok, I contacted them. I’ll let you guys know.
    
                        ________________________________
                        From: Carlos Rovira <ca...@apache.org>
                        Sent: Sunday, January 12, 2020 6:58:17 PM
                        To: dev@royale.apache.org <de...@royale.apache.org>
                        Subject: Re: YFiles, EPL, Apache
    
                        Hi,
    
                        I think you should contact yFiles directly and talk with them about it.
                        That's better to try to figure if something could be wrong in the future.
    
                        My understanding is that he should be able to give you permission since it
                        implies make his commercial lib to clients that want to use in Royale.
                        So that clientes will still need to pay for the commercial version, while
                        if no typedefs are done, it will be more difficult to do.
    
    
    
                        El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
                        escribió:
    
                        >
                        > Hi,
                        >
                        > Before I start making inquiries in legal I wonder if anyone here can give
                        > me some guidance.
                        >
                        > I want to create typedefs for yFiles [1], using an externs [2] file that’s
                        > under an EPL [3]. Should that be a problem?
                        >
                        > This issue [4] makes me extra cautious.
                        >
                        > Thanks.
                        >
                        > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=slXu8Ddrx%2FJ6wLBPmzzXTyl9fLlPfZFAK97rB7LGEfA%3D&amp;reserved=0
                        > [2]
                        > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=g%2FINc05LaGKDnWYFa1hnWtfXh52VBnD76Zs8Vampf0U%3D&amp;reserved=0
                        > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=vd9zuLouHhMI%2ByovqI4Uy%2FqNgtegO8%2FaQ%2FhZnI4SeMw%3D&amp;reserved=0
                        > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=psvygNG2%2F%2F5IlP49G0sUOc2%2BNRaNR9mHaGDaLdbWWFY%3D&amp;reserved=0
                        >
    
    
                        --
                        Carlos Rovira
                        https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7C2e2303d87f3149272d4908d7aa123d22%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164867623454469&amp;sdata=j5YsKuAXvyFTDjRcgsOp1ksLCfZQ42BhcSXvYvtdnZo%3D&amp;reserved=0
    
    
    
    
    
    
    
    
    
    
    
    


RE: YFiles, EPL, Apache

Posted by Yishay Weiss <yi...@hotmail.com>.
You’re right about yfiles being the only one needing a var prefix. I sent a more detailed response, but my mails are getting bounced from the list for some reason. Will try to work privately with Sebastian on this.

From: Alex Harui<ma...@adobe.com.INVALID>
Sent: Tuesday, February 4, 2020 7:33 PM
To: dev@royale.apache.org<ma...@royale.apache.org>; Alex Harui<ma...@adobe.com.INVALID>
Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
Subject: Re: YFiles, EPL, Apache

Looking more carefully at the file, I think the warning you posted should be the only one like that.  Aren't you getting other errors for some of the classes?

I don't know if Sebastian is still following this discussion, but it looks like with a few changes, that file could be a valid Google Closure Externs file and would then open up use of YFiles for folks who use the Google Closure Compiler, which would hopefully be a significant market for them.

Yishay, if you have time you can either manually manipulate that file and get it to parse cleanly or write a tool that does it.  I think you first have to change:

/**
 * @namespace
 */
yfiles={};

To:

/**
 * @namespace
 * @const
 */
var yfiles={};

Then find places where class members are defined before the class constructor and change the order.  So I saw that their Map class constructor is on line 51, after the first Map member definition on line 22.  Move line 51 with its JSDoc before line 22's JSDoc and see if the warning goes away and the Map class is generated.

If you write a tool, it could just for a.b.c.x being defined before a.b.c.

HTH,
-Alex

On 2/4/20, 7:18 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    The interfaces seem to be generated ok, but not classes. I’m getting warnings such as

         [java] WARNING: [yfiles]:14: WARNING - accessing name yfiles in externs has no effect. Perhaps you forgot to add a var keyword?
         [java] yfiles={};
         [java] ^^^^^^

    From: Alex Harui<ma...@adobe.com.INVALID>
    Sent: Tuesday, February 4, 2020 6:33 AM
    To: dev@royale.apache.org<ma...@royale.apache.org>; Alex Harui<ma...@adobe.com.INVALID>
    Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
    Subject: Re: YFiles, EPL, Apache

    Yishay,

    Did you try to run this file through the Royale Externs Compiler?  It looks a lot like Google Closure Externs format to me.  You might get lucky and it will  "just work" or there will be errors and we can discuss whether YFiles wants to have a file that can be directly used by the Google Closure Compiler or not.

    -Alex

    On 2/3/20, 7:02 PM, "Alex Harui" <ah...@adobe.com.INVALID> wrote:

        Is this JSDoc file on the internet so I can take a look?

        The Royale Externs Compiler uses Google Closure's JavaScript parser because externs/typedefs are supposed to be a specially-formatted but valid JavaScript, so an AST (different from the one that we generate from MXML/AS) can be created from Closure-compatible JavaScript.  It may be possible/better to work from the Closure AST in this case.

        HTH,
        -Alex

        On 2/3/20, 6:57 PM, "Yishay Weiss" <yi...@hotmail.com> wrote:

            Yes, they do have a jsdoc file. Do you think it would be easier to maintain a conversion tool for that?
            ________________________________
            From: Alex Harui <ah...@adobe.com.INVALID>
            Sent: Monday, February 3, 2020 8:54:00 PM
            To: dev@royale.apache.org <de...@royale.apache.org>
            Cc: sebastian.mueller@yworks.com <se...@yworks.com>
            Subject: Re: YFiles, EPL, Apache

            I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.

            -Alex

            On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

                Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.

                [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367242281&amp;sdata=vwj5%2BUjX1z9uNk5fI3R%2F08SekA0LmL26lAldSieyh6o%3D&amp;reserved=0
                [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367242281&amp;sdata=xCecu7gdYw7y5C4cVr62K5C6Rmr1V%2BUCadMWKy%2FBpYM%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=r4Udk5sfXD%2BXAJTXC0pBOFpC5DD12GCUpd%2FTVjLkyeM%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=31Hk7CeqbAhvlIOD0V3B8vhyUhWCN7Wx0TVJ9lTJ8mE%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367242281&amp;sdata=xCecu7gdYw7y5C4cVr62K5C6Rmr1V%2BUCadMWKy%2FBpYM%3D&amp;reserved=0%5d%3chttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=r4Udk5sfXD%2BXAJTXC0pBOFpC5DD12GCUpd%2FTVjLkyeM%3D&amp;reserved=0%3chttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=31Hk7CeqbAhvlIOD0V3B8vhyUhWCN7Wx0TVJ9lTJ8mE%3D&amp;reserved=0>>>
                GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=r4Udk5sfXD%2BXAJTXC0pBOFpC5DD12GCUpd%2FTVjLkyeM%3D&amp;reserved=0>
                Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
                github.com

                ________________________________
                From: Alex Harui <ah...@adobe.com.INVALID>
                Sent: Monday, February 3, 2020 4:40 PM
                To: dev@royale.apache.org <de...@royale.apache.org>
                Cc: sebastian.mueller@yworks.com <se...@yworks.com>
                Subject: Re: YFiles, EPL, Apache

                I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.

                -Alex

                On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

                    Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.

                    [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=zt4awTFwC8HxYtwREcZH2y4xrSsJN9Z6G5lmlZK12N8%3D&amp;reserved=0
                    [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=64XpHsni9A77M8n2iyxAa5MneGhyGhnU9jfVJURsH4U%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=Hlq7SDjjqeqJFUxq604LGacPjBuPJyHqGAfTAhMGXYU%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=64XpHsni9A77M8n2iyxAa5MneGhyGhnU9jfVJURsH4U%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=64XpHsni9A77M8n2iyxAa5MneGhyGhnU9jfVJURsH4U%3D&amp;reserved=0%3chttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=Hlq7SDjjqeqJFUxq604LGacPjBuPJyHqGAfTAhMGXYU%3D&amp;reserved=0%3chttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=64XpHsni9A77M8n2iyxAa5MneGhyGhnU9jfVJURsH4U%3D&amp;reserved=0>>>
                    [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=7LOzGP%2Bg1G8lfDLUdzyaXyU%2BSrarZdKrR8EOw4A3MVY%3D&amp;reserved=0

                    From: Yishay Weiss<ma...@hotmail.com>
                    Sent: Monday, February 3, 2020 2:57 PM
                    To: dev@royale.apache.org<ma...@royale.apache.org>
                    Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
                    Subject: RE: YFiles, EPL, Apache

                    As promised, here is the summary of my correspondence with yFiles.

                    > My questions to Sebastian from yWorks:
                    >
                    > a) Would yWorks allow us to create and publish typedefs (think of them
                    > as Royale d.ts files) in our GitHub repository? I would also need to
                    > check license issues on the Apache side.

                    Our license does not allow publishing such files, which would be
                    derivative works from files which are currently under our proprietary
                    license. Although we could grant you permission to do that, we are
                    currently very hesitant to do so. Here's why: Unless there is someone
                    who actively maintains these typings, they would quickly become outdated
                    because with every new release we add new features and APIs. The only
                    way someone could reasonably maintain such a file (about 10k public API
                    members, 7 MB TypeScript definition file) would be through a
                    (semi-automatic?) conversion process. Thus both from a practical and
                    legal perspective it would make a lot more sense to have a tool that
                    reads our API definition files and creates the typedefs. Any licensed
                    yFiles user could make use of this tool and would always get the
                    typedefs matching her yFiles version.

                    For you reference: This is what someone else did to get yFiles for HTML
                    to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=5CPmpNE4gtbtTWcQ91za%2B3e16Z6aI%2Fm%2BshfTF99C4vQ%3D&amp;reserved=0
                    They got explicit permission from us for this (because they do not
                    publish the original files).

                    >
                    > b) Would yWorks consider porting yFiles to Royale?

                    Yes, if and once we get reasonable amount of feedback and customer
                    interest. If you're interested in licensing yFiles for Apache Royale,
                    please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=umi3iFM0YIY3iQs4g7LtOaj1ZqWQ8TcCd8lYs%2FYaoqU%3D&amp;reserved=0>
                    FWIW the vast majoriy of our previous yFiles FLEX customers has
                    successfully migrated to "native web" technologies and is now happily
                    using yFiles for HTML: With the current state of Apache Royale and the
                    web, we don't see that Apache Royale has gained enough traction that
                    would justify the efforts.
                    We currently believe that creating the diagramming part using "classic"
                    TypeScript/JavaScript and wrapping the resulting component up in a small
                    Royale component with a tiny API surface is the superios and more
                    efficient approach.


                    From: Yishay Weiss<ma...@hotmail.com>
                    Sent: Sunday, January 12, 2020 11:37 PM
                    To: dev@royale.apache.org<ma...@royale.apache.org>
                    Subject: RE: YFiles, EPL, Apache

                    Ok, I contacted them. I’ll let you guys know.

                    ________________________________
                    From: Carlos Rovira <ca...@apache.org>
                    Sent: Sunday, January 12, 2020 6:58:17 PM
                    To: dev@royale.apache.org <de...@royale.apache.org>
                    Subject: Re: YFiles, EPL, Apache

                    Hi,

                    I think you should contact yFiles directly and talk with them about it.
                    That's better to try to figure if something could be wrong in the future.

                    My understanding is that he should be able to give you permission since it
                    implies make his commercial lib to clients that want to use in Royale.
                    So that clientes will still need to pay for the commercial version, while
                    if no typedefs are done, it will be more difficult to do.



                    El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
                    escribió:

                    >
                    > Hi,
                    >
                    > Before I start making inquiries in legal I wonder if anyone here can give
                    > me some guidance.
                    >
                    > I want to create typedefs for yFiles [1], using an externs [2] file that’s
                    > under an EPL [3]. Should that be a problem?
                    >
                    > This issue [4] makes me extra cautious.
                    >
                    > Thanks.
                    >
                    > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=kj7mkZg71GRi04xWT%2BeYRM5I0bcezP1E0JvKhhyDzJQ%3D&amp;reserved=0
                    > [2]
                    > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=XCiiHhUprj7lJQRqgMNZSI4QKdnQXjIh5ColsDYc%2Fh8%3D&amp;reserved=0
                    > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=%2F%2Bh%2B4l2szo8LuiM4v6ntVa45QzgKTKF%2Fe%2BwbHgHxYcw%3D&amp;reserved=0
                    > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=63UKLX2bBWRSxYqfJi8BqMUxTHxVFSJLULNVpycOE%2FU%3D&amp;reserved=0
                    >


                    --
                    Carlos Rovira
                    https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=Mhkrwt3Lfx03P2P5alBZSkYjH0oxRh%2F26Wy8%2FNopCuU%3D&amp;reserved=0












Re: YFiles, EPL, Apache

Posted by Alex Harui <ah...@adobe.com.INVALID>.
Looking more carefully at the file, I think the warning you posted should be the only one like that.  Aren't you getting other errors for some of the classes?

I don't know if Sebastian is still following this discussion, but it looks like with a few changes, that file could be a valid Google Closure Externs file and would then open up use of YFiles for folks who use the Google Closure Compiler, which would hopefully be a significant market for them.

Yishay, if you have time you can either manually manipulate that file and get it to parse cleanly or write a tool that does it.  I think you first have to change:

/**
 * @namespace
 */
yfiles={};

To:

/**
 * @namespace
 * @const
 */
var yfiles={};

Then find places where class members are defined before the class constructor and change the order.  So I saw that their Map class constructor is on line 51, after the first Map member definition on line 22.  Move line 51 with its JSDoc before line 22's JSDoc and see if the warning goes away and the Map class is generated.

If you write a tool, it could just for a.b.c.x being defined before a.b.c.

HTH,
-Alex

On 2/4/20, 7:18 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    The interfaces seem to be generated ok, but not classes. I’m getting warnings such as
    
         [java] WARNING: [yfiles]:14: WARNING - accessing name yfiles in externs has no effect. Perhaps you forgot to add a var keyword?
         [java] yfiles={};
         [java] ^^^^^^
    
    From: Alex Harui<ma...@adobe.com.INVALID>
    Sent: Tuesday, February 4, 2020 6:33 AM
    To: dev@royale.apache.org<ma...@royale.apache.org>; Alex Harui<ma...@adobe.com.INVALID>
    Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
    Subject: Re: YFiles, EPL, Apache
    
    Yishay,
    
    Did you try to run this file through the Royale Externs Compiler?  It looks a lot like Google Closure Externs format to me.  You might get lucky and it will  "just work" or there will be errors and we can discuss whether YFiles wants to have a file that can be directly used by the Google Closure Compiler or not.
    
    -Alex
    
    On 2/3/20, 7:02 PM, "Alex Harui" <ah...@adobe.com.INVALID> wrote:
    
        Is this JSDoc file on the internet so I can take a look?
    
        The Royale Externs Compiler uses Google Closure's JavaScript parser because externs/typedefs are supposed to be a specially-formatted but valid JavaScript, so an AST (different from the one that we generate from MXML/AS) can be created from Closure-compatible JavaScript.  It may be possible/better to work from the Closure AST in this case.
    
        HTH,
        -Alex
    
        On 2/3/20, 6:57 PM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
            Yes, they do have a jsdoc file. Do you think it would be easier to maintain a conversion tool for that?
            ________________________________
            From: Alex Harui <ah...@adobe.com.INVALID>
            Sent: Monday, February 3, 2020 8:54:00 PM
            To: dev@royale.apache.org <de...@royale.apache.org>
            Cc: sebastian.mueller@yworks.com <se...@yworks.com>
            Subject: Re: YFiles, EPL, Apache
    
            I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.
    
            -Alex
    
            On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
                Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.
    
                [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367242281&amp;sdata=vwj5%2BUjX1z9uNk5fI3R%2F08SekA0LmL26lAldSieyh6o%3D&amp;reserved=0
                [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367242281&amp;sdata=xCecu7gdYw7y5C4cVr62K5C6Rmr1V%2BUCadMWKy%2FBpYM%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=r4Udk5sfXD%2BXAJTXC0pBOFpC5DD12GCUpd%2FTVjLkyeM%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=31Hk7CeqbAhvlIOD0V3B8vhyUhWCN7Wx0TVJ9lTJ8mE%3D&amp;reserved=0>>
                GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=r4Udk5sfXD%2BXAJTXC0pBOFpC5DD12GCUpd%2FTVjLkyeM%3D&amp;reserved=0>
                Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
                github.com
    
                ________________________________
                From: Alex Harui <ah...@adobe.com.INVALID>
                Sent: Monday, February 3, 2020 4:40 PM
                To: dev@royale.apache.org <de...@royale.apache.org>
                Cc: sebastian.mueller@yworks.com <se...@yworks.com>
                Subject: Re: YFiles, EPL, Apache
    
                I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.
    
                -Alex
    
                On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
                    Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.
    
                    [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=zt4awTFwC8HxYtwREcZH2y4xrSsJN9Z6G5lmlZK12N8%3D&amp;reserved=0
                    [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=64XpHsni9A77M8n2iyxAa5MneGhyGhnU9jfVJURsH4U%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=Hlq7SDjjqeqJFUxq604LGacPjBuPJyHqGAfTAhMGXYU%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=64XpHsni9A77M8n2iyxAa5MneGhyGhnU9jfVJURsH4U%3D&amp;reserved=0>>
                    [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=7LOzGP%2Bg1G8lfDLUdzyaXyU%2BSrarZdKrR8EOw4A3MVY%3D&amp;reserved=0
    
                    From: Yishay Weiss<ma...@hotmail.com>
                    Sent: Monday, February 3, 2020 2:57 PM
                    To: dev@royale.apache.org<ma...@royale.apache.org>
                    Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
                    Subject: RE: YFiles, EPL, Apache
    
                    As promised, here is the summary of my correspondence with yFiles.
    
                    > My questions to Sebastian from yWorks:
                    >
                    > a) Would yWorks allow us to create and publish typedefs (think of them
                    > as Royale d.ts files) in our GitHub repository? I would also need to
                    > check license issues on the Apache side.
    
                    Our license does not allow publishing such files, which would be
                    derivative works from files which are currently under our proprietary
                    license. Although we could grant you permission to do that, we are
                    currently very hesitant to do so. Here's why: Unless there is someone
                    who actively maintains these typings, they would quickly become outdated
                    because with every new release we add new features and APIs. The only
                    way someone could reasonably maintain such a file (about 10k public API
                    members, 7 MB TypeScript definition file) would be through a
                    (semi-automatic?) conversion process. Thus both from a practical and
                    legal perspective it would make a lot more sense to have a tool that
                    reads our API definition files and creates the typedefs. Any licensed
                    yFiles user could make use of this tool and would always get the
                    typedefs matching her yFiles version.
    
                    For you reference: This is what someone else did to get yFiles for HTML
                    to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367252278&amp;sdata=5CPmpNE4gtbtTWcQ91za%2B3e16Z6aI%2Fm%2BshfTF99C4vQ%3D&amp;reserved=0
                    They got explicit permission from us for this (because they do not
                    publish the original files).
    
                    >
                    > b) Would yWorks consider porting yFiles to Royale?
    
                    Yes, if and once we get reasonable amount of feedback and customer
                    interest. If you're interested in licensing yFiles for Apache Royale,
                    please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=umi3iFM0YIY3iQs4g7LtOaj1ZqWQ8TcCd8lYs%2FYaoqU%3D&amp;reserved=0>
                    FWIW the vast majoriy of our previous yFiles FLEX customers has
                    successfully migrated to "native web" technologies and is now happily
                    using yFiles for HTML: With the current state of Apache Royale and the
                    web, we don't see that Apache Royale has gained enough traction that
                    would justify the efforts.
                    We currently believe that creating the diagramming part using "classic"
                    TypeScript/JavaScript and wrapping the resulting component up in a small
                    Royale component with a tiny API surface is the superios and more
                    efficient approach.
    
    
                    From: Yishay Weiss<ma...@hotmail.com>
                    Sent: Sunday, January 12, 2020 11:37 PM
                    To: dev@royale.apache.org<ma...@royale.apache.org>
                    Subject: RE: YFiles, EPL, Apache
    
                    Ok, I contacted them. I’ll let you guys know.
    
                    ________________________________
                    From: Carlos Rovira <ca...@apache.org>
                    Sent: Sunday, January 12, 2020 6:58:17 PM
                    To: dev@royale.apache.org <de...@royale.apache.org>
                    Subject: Re: YFiles, EPL, Apache
    
                    Hi,
    
                    I think you should contact yFiles directly and talk with them about it.
                    That's better to try to figure if something could be wrong in the future.
    
                    My understanding is that he should be able to give you permission since it
                    implies make his commercial lib to clients that want to use in Royale.
                    So that clientes will still need to pay for the commercial version, while
                    if no typedefs are done, it will be more difficult to do.
    
    
    
                    El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
                    escribió:
    
                    >
                    > Hi,
                    >
                    > Before I start making inquiries in legal I wonder if anyone here can give
                    > me some guidance.
                    >
                    > I want to create typedefs for yFiles [1], using an externs [2] file that’s
                    > under an EPL [3]. Should that be a problem?
                    >
                    > This issue [4] makes me extra cautious.
                    >
                    > Thanks.
                    >
                    > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=kj7mkZg71GRi04xWT%2BeYRM5I0bcezP1E0JvKhhyDzJQ%3D&amp;reserved=0
                    > [2]
                    > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=XCiiHhUprj7lJQRqgMNZSI4QKdnQXjIh5ColsDYc%2Fh8%3D&amp;reserved=0
                    > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=%2F%2Bh%2B4l2szo8LuiM4v6ntVa45QzgKTKF%2Fe%2BwbHgHxYcw%3D&amp;reserved=0
                    > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=63UKLX2bBWRSxYqfJi8BqMUxTHxVFSJLULNVpycOE%2FU%3D&amp;reserved=0
                    >
    
    
                    --
                    Carlos Rovira
                    https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7Cd5055275b6dc4466549908d7a9858c55%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637164263367262267&amp;sdata=Mhkrwt3Lfx03P2P5alBZSkYjH0oxRh%2F26Wy8%2FNopCuU%3D&amp;reserved=0
    
    
    
    
    
    
    
    
    
    


RE: YFiles, EPL, Apache

Posted by Yishay Weiss <yi...@hotmail.com>.
The interfaces seem to be generated ok, but not classes. I’m getting warnings such as

     [java] WARNING: [yfiles]:14: WARNING - accessing name yfiles in externs has no effect. Perhaps you forgot to add a var keyword?
     [java] yfiles={};
     [java] ^^^^^^

From: Alex Harui<ma...@adobe.com.INVALID>
Sent: Tuesday, February 4, 2020 6:33 AM
To: dev@royale.apache.org<ma...@royale.apache.org>; Alex Harui<ma...@adobe.com.INVALID>
Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
Subject: Re: YFiles, EPL, Apache

Yishay,

Did you try to run this file through the Royale Externs Compiler?  It looks a lot like Google Closure Externs format to me.  You might get lucky and it will  "just work" or there will be errors and we can discuss whether YFiles wants to have a file that can be directly used by the Google Closure Compiler or not.

-Alex

On 2/3/20, 7:02 PM, "Alex Harui" <ah...@adobe.com.INVALID> wrote:

    Is this JSDoc file on the internet so I can take a look?

    The Royale Externs Compiler uses Google Closure's JavaScript parser because externs/typedefs are supposed to be a specially-formatted but valid JavaScript, so an AST (different from the one that we generate from MXML/AS) can be created from Closure-compatible JavaScript.  It may be possible/better to work from the Closure AST in this case.

    HTH,
    -Alex

    On 2/3/20, 6:57 PM, "Yishay Weiss" <yi...@hotmail.com> wrote:

        Yes, they do have a jsdoc file. Do you think it would be easier to maintain a conversion tool for that?
        ________________________________
        From: Alex Harui <ah...@adobe.com.INVALID>
        Sent: Monday, February 3, 2020 8:54:00 PM
        To: dev@royale.apache.org <de...@royale.apache.org>
        Cc: sebastian.mueller@yworks.com <se...@yworks.com>
        Subject: Re: YFiles, EPL, Apache

        I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.

        -Alex

        On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

            Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.

            [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536432303&amp;sdata=OLF0B4CKbSzLbt%2BDmp0r9Krh%2FN8KUdoMsqepU3RuCVI%3D&amp;reserved=0
            [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536432303&amp;sdata=5YvY%2Fr9mgJzq6AgygF2eowFVttgh3O7xvQKz8CcbPpQ%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=eeGVMThiuNzg8kIuSjn3O%2BCKgtZA4UxyNtPdHeNteUA%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536432303&amp;sdata=5YvY%2Fr9mgJzq6AgygF2eowFVttgh3O7xvQKz8CcbPpQ%3D&amp;reserved=0%5d%3chttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=eeGVMThiuNzg8kIuSjn3O%2BCKgtZA4UxyNtPdHeNteUA%3D&amp;reserved=0>>
            GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=eeGVMThiuNzg8kIuSjn3O%2BCKgtZA4UxyNtPdHeNteUA%3D&amp;reserved=0>
            Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
            github.com

            ________________________________
            From: Alex Harui <ah...@adobe.com.INVALID>
            Sent: Monday, February 3, 2020 4:40 PM
            To: dev@royale.apache.org <de...@royale.apache.org>
            Cc: sebastian.mueller@yworks.com <se...@yworks.com>
            Subject: Re: YFiles, EPL, Apache

            I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.

            -Alex

            On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

                Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.

                [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=RFtVbmDSN0z9kBRHOuICEcgqFa43L0yYY7TfwPtpuZw%3D&amp;reserved=0
                [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=ADkZNEf1l28Nau%2FHhiEjxRIA3LdIf7K%2BUpZiCC9e338%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=PPY8b4mGJtc3IjQ1%2F2mbGl4F%2Bq3epfI5saKD89iiF1c%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=ADkZNEf1l28Nau%2FHhiEjxRIA3LdIf7K%2BUpZiCC9e338%3D&amp;reserved=0%3chttps://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=PPY8b4mGJtc3IjQ1%2F2mbGl4F%2Bq3epfI5saKD89iiF1c%3D&amp;reserved=0>>
                [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=KJxJgYx%2BhhhTVqM1eZw72J1aJSJ1wWazailvKZAQsiM%3D&amp;reserved=0

                From: Yishay Weiss<ma...@hotmail.com>
                Sent: Monday, February 3, 2020 2:57 PM
                To: dev@royale.apache.org<ma...@royale.apache.org>
                Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
                Subject: RE: YFiles, EPL, Apache

                As promised, here is the summary of my correspondence with yFiles.

                > My questions to Sebastian from yWorks:
                >
                > a) Would yWorks allow us to create and publish typedefs (think of them
                > as Royale d.ts files) in our GitHub repository? I would also need to
                > check license issues on the Apache side.

                Our license does not allow publishing such files, which would be
                derivative works from files which are currently under our proprietary
                license. Although we could grant you permission to do that, we are
                currently very hesitant to do so. Here's why: Unless there is someone
                who actively maintains these typings, they would quickly become outdated
                because with every new release we add new features and APIs. The only
                way someone could reasonably maintain such a file (about 10k public API
                members, 7 MB TypeScript definition file) would be through a
                (semi-automatic?) conversion process. Thus both from a practical and
                legal perspective it would make a lot more sense to have a tool that
                reads our API definition files and creates the typedefs. Any licensed
                yFiles user could make use of this tool and would always get the
                typedefs matching her yFiles version.

                For you reference: This is what someone else did to get yFiles for HTML
                to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=4pDyPbjxRHf6MRu4cioVNGCVhvo8f%2FDA97V0dZ9BTeY%3D&amp;reserved=0
                They got explicit permission from us for this (because they do not
                publish the original files).

                >
                > b) Would yWorks consider porting yFiles to Royale?

                Yes, if and once we get reasonable amount of feedback and customer
                interest. If you're interested in licensing yFiles for Apache Royale,
                please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=Q5lN%2Fgx9jVAaaO7hGPc9qhCpXEdittkGq2VtpQRSAEQ%3D&amp;reserved=0>
                FWIW the vast majoriy of our previous yFiles FLEX customers has
                successfully migrated to "native web" technologies and is now happily
                using yFiles for HTML: With the current state of Apache Royale and the
                web, we don't see that Apache Royale has gained enough traction that
                would justify the efforts.
                We currently believe that creating the diagramming part using "classic"
                TypeScript/JavaScript and wrapping the resulting component up in a small
                Royale component with a tiny API surface is the superios and more
                efficient approach.


                From: Yishay Weiss<ma...@hotmail.com>
                Sent: Sunday, January 12, 2020 11:37 PM
                To: dev@royale.apache.org<ma...@royale.apache.org>
                Subject: RE: YFiles, EPL, Apache

                Ok, I contacted them. I’ll let you guys know.

                ________________________________
                From: Carlos Rovira <ca...@apache.org>
                Sent: Sunday, January 12, 2020 6:58:17 PM
                To: dev@royale.apache.org <de...@royale.apache.org>
                Subject: Re: YFiles, EPL, Apache

                Hi,

                I think you should contact yFiles directly and talk with them about it.
                That's better to try to figure if something could be wrong in the future.

                My understanding is that he should be able to give you permission since it
                implies make his commercial lib to clients that want to use in Royale.
                So that clientes will still need to pay for the commercial version, while
                if no typedefs are done, it will be more difficult to do.



                El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
                escribió:

                >
                > Hi,
                >
                > Before I start making inquiries in legal I wonder if anyone here can give
                > me some guidance.
                >
                > I want to create typedefs for yFiles [1], using an externs [2] file that’s
                > under an EPL [3]. Should that be a problem?
                >
                > This issue [4] makes me extra cautious.
                >
                > Thanks.
                >
                > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=kSmX22USP31BsFHili1%2BdNcbZAIGTKO7QjrR1zQIkFQ%3D&amp;reserved=0
                > [2]
                > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=RFtVbmDSN0z9kBRHOuICEcgqFa43L0yYY7TfwPtpuZw%3D&amp;reserved=0
                > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=0fWuR2bRgZnk9euhCcgQYGRDFf3hcOWtNkemVHJ3%2Bec%3D&amp;reserved=0
                > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=E%2Fcf3RqcNg0sAPX5eJdbLu9okE0GROXtZAmxFzBWcQE%3D&amp;reserved=0
                >


                --
                Carlos Rovira
                https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536452211&amp;sdata=U3oX%2BdhU0rftQuWu7P702tWsCk6g1QDgqpefK4AwCdo%3D&amp;reserved=0










Re: YFiles, EPL, Apache

Posted by Alex Harui <ah...@adobe.com.INVALID>.
Yishay,

Did you try to run this file through the Royale Externs Compiler?  It looks a lot like Google Closure Externs format to me.  You might get lucky and it will  "just work" or there will be errors and we can discuss whether YFiles wants to have a file that can be directly used by the Google Closure Compiler or not.

-Alex

On 2/3/20, 7:02 PM, "Alex Harui" <ah...@adobe.com.INVALID> wrote:

    Is this JSDoc file on the internet so I can take a look?
    
    The Royale Externs Compiler uses Google Closure's JavaScript parser because externs/typedefs are supposed to be a specially-formatted but valid JavaScript, so an AST (different from the one that we generate from MXML/AS) can be created from Closure-compatible JavaScript.  It may be possible/better to work from the Closure AST in this case.
    
    HTH,
    -Alex
    
    On 2/3/20, 6:57 PM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
        Yes, they do have a jsdoc file. Do you think it would be easier to maintain a conversion tool for that?
        ________________________________
        From: Alex Harui <ah...@adobe.com.INVALID>
        Sent: Monday, February 3, 2020 8:54:00 PM
        To: dev@royale.apache.org <de...@royale.apache.org>
        Cc: sebastian.mueller@yworks.com <se...@yworks.com>
        Subject: Re: YFiles, EPL, Apache
        
        I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.
        
        -Alex
        
        On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
        
            Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.
        
            [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536432303&amp;sdata=OLF0B4CKbSzLbt%2BDmp0r9Krh%2FN8KUdoMsqepU3RuCVI%3D&amp;reserved=0
            [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536432303&amp;sdata=5YvY%2Fr9mgJzq6AgygF2eowFVttgh3O7xvQKz8CcbPpQ%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=eeGVMThiuNzg8kIuSjn3O%2BCKgtZA4UxyNtPdHeNteUA%3D&amp;reserved=0>
            GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=eeGVMThiuNzg8kIuSjn3O%2BCKgtZA4UxyNtPdHeNteUA%3D&amp;reserved=0>
            Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
            github.com
        
            ________________________________
            From: Alex Harui <ah...@adobe.com.INVALID>
            Sent: Monday, February 3, 2020 4:40 PM
            To: dev@royale.apache.org <de...@royale.apache.org>
            Cc: sebastian.mueller@yworks.com <se...@yworks.com>
            Subject: Re: YFiles, EPL, Apache
        
            I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.
        
            -Alex
        
            On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
        
                Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.
        
                [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=RFtVbmDSN0z9kBRHOuICEcgqFa43L0yYY7TfwPtpuZw%3D&amp;reserved=0
                [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=ADkZNEf1l28Nau%2FHhiEjxRIA3LdIf7K%2BUpZiCC9e338%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=PPY8b4mGJtc3IjQ1%2F2mbGl4F%2Bq3epfI5saKD89iiF1c%3D&amp;reserved=0>
                [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=KJxJgYx%2BhhhTVqM1eZw72J1aJSJ1wWazailvKZAQsiM%3D&amp;reserved=0
        
                From: Yishay Weiss<ma...@hotmail.com>
                Sent: Monday, February 3, 2020 2:57 PM
                To: dev@royale.apache.org<ma...@royale.apache.org>
                Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
                Subject: RE: YFiles, EPL, Apache
        
                As promised, here is the summary of my correspondence with yFiles.
        
                > My questions to Sebastian from yWorks:
                >
                > a) Would yWorks allow us to create and publish typedefs (think of them
                > as Royale d.ts files) in our GitHub repository? I would also need to
                > check license issues on the Apache side.
        
                Our license does not allow publishing such files, which would be
                derivative works from files which are currently under our proprietary
                license. Although we could grant you permission to do that, we are
                currently very hesitant to do so. Here's why: Unless there is someone
                who actively maintains these typings, they would quickly become outdated
                because with every new release we add new features and APIs. The only
                way someone could reasonably maintain such a file (about 10k public API
                members, 7 MB TypeScript definition file) would be through a
                (semi-automatic?) conversion process. Thus both from a practical and
                legal perspective it would make a lot more sense to have a tool that
                reads our API definition files and creates the typedefs. Any licensed
                yFiles user could make use of this tool and would always get the
                typedefs matching her yFiles version.
        
                For you reference: This is what someone else did to get yFiles for HTML
                to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=4pDyPbjxRHf6MRu4cioVNGCVhvo8f%2FDA97V0dZ9BTeY%3D&amp;reserved=0
                They got explicit permission from us for this (because they do not
                publish the original files).
        
                >
                > b) Would yWorks consider porting yFiles to Royale?
        
                Yes, if and once we get reasonable amount of feedback and customer
                interest. If you're interested in licensing yFiles for Apache Royale,
                please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=Q5lN%2Fgx9jVAaaO7hGPc9qhCpXEdittkGq2VtpQRSAEQ%3D&amp;reserved=0>
                FWIW the vast majoriy of our previous yFiles FLEX customers has
                successfully migrated to "native web" technologies and is now happily
                using yFiles for HTML: With the current state of Apache Royale and the
                web, we don't see that Apache Royale has gained enough traction that
                would justify the efforts.
                We currently believe that creating the diagramming part using "classic"
                TypeScript/JavaScript and wrapping the resulting component up in a small
                Royale component with a tiny API surface is the superios and more
                efficient approach.
        
        
                From: Yishay Weiss<ma...@hotmail.com>
                Sent: Sunday, January 12, 2020 11:37 PM
                To: dev@royale.apache.org<ma...@royale.apache.org>
                Subject: RE: YFiles, EPL, Apache
        
                Ok, I contacted them. I’ll let you guys know.
        
                ________________________________
                From: Carlos Rovira <ca...@apache.org>
                Sent: Sunday, January 12, 2020 6:58:17 PM
                To: dev@royale.apache.org <de...@royale.apache.org>
                Subject: Re: YFiles, EPL, Apache
        
                Hi,
        
                I think you should contact yFiles directly and talk with them about it.
                That's better to try to figure if something could be wrong in the future.
        
                My understanding is that he should be able to give you permission since it
                implies make his commercial lib to clients that want to use in Royale.
                So that clientes will still need to pay for the commercial version, while
                if no typedefs are done, it will be more difficult to do.
        
        
        
                El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
                escribió:
        
                >
                > Hi,
                >
                > Before I start making inquiries in legal I wonder if anyone here can give
                > me some guidance.
                >
                > I want to create typedefs for yFiles [1], using an externs [2] file that’s
                > under an EPL [3]. Should that be a problem?
                >
                > This issue [4] makes me extra cautious.
                >
                > Thanks.
                >
                > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=kSmX22USP31BsFHili1%2BdNcbZAIGTKO7QjrR1zQIkFQ%3D&amp;reserved=0
                > [2]
                > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=RFtVbmDSN0z9kBRHOuICEcgqFa43L0yYY7TfwPtpuZw%3D&amp;reserved=0
                > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=0fWuR2bRgZnk9euhCcgQYGRDFf3hcOWtNkemVHJ3%2Bec%3D&amp;reserved=0
                > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536442259&amp;sdata=E%2Fcf3RqcNg0sAPX5eJdbLu9okE0GROXtZAmxFzBWcQE%3D&amp;reserved=0
                >
        
        
                --
                Carlos Rovira
                https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7Ce929a929c96749685f4308d7a91ead85%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163821536452211&amp;sdata=U3oX%2BdhU0rftQuWu7P702tWsCk6g1QDgqpefK4AwCdo%3D&amp;reserved=0
        
        
        
        
        
        
    
    


Re: YFiles, EPL, Apache

Posted by Alex Harui <ah...@adobe.com.INVALID>.
Is this JSDoc file on the internet so I can take a look?

The Royale Externs Compiler uses Google Closure's JavaScript parser because externs/typedefs are supposed to be a specially-formatted but valid JavaScript, so an AST (different from the one that we generate from MXML/AS) can be created from Closure-compatible JavaScript.  It may be possible/better to work from the Closure AST in this case.

HTH,
-Alex

On 2/3/20, 6:57 PM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    Yes, they do have a jsdoc file. Do you think it would be easier to maintain a conversion tool for that?
    ________________________________
    From: Alex Harui <ah...@adobe.com.INVALID>
    Sent: Monday, February 3, 2020 8:54:00 PM
    To: dev@royale.apache.org <de...@royale.apache.org>
    Cc: sebastian.mueller@yworks.com <se...@yworks.com>
    Subject: Re: YFiles, EPL, Apache
    
    I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.
    
    -Alex
    
    On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
        Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.
    
        [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418293642&amp;sdata=7tqKiq1pN2i5e2RC4vT1exZzAr3tSQHCamnog82%2FOYM%3D&amp;reserved=0
        [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418293642&amp;sdata=wKHvUS8Fi%2Bfsh%2F98jAYWMmw6%2Bk%2Bb9041%2BnANm1ZZ9Mk%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418293642&amp;sdata=7tqKiq1pN2i5e2RC4vT1exZzAr3tSQHCamnog82%2FOYM%3D&amp;reserved=0>
        GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418293642&amp;sdata=7tqKiq1pN2i5e2RC4vT1exZzAr3tSQHCamnog82%2FOYM%3D&amp;reserved=0>
        Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
        github.com
    
        ________________________________
        From: Alex Harui <ah...@adobe.com.INVALID>
        Sent: Monday, February 3, 2020 4:40 PM
        To: dev@royale.apache.org <de...@royale.apache.org>
        Cc: sebastian.mueller@yworks.com <se...@yworks.com>
        Subject: Re: YFiles, EPL, Apache
    
        I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.
    
        -Alex
    
        On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
            Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.
    
            [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418293642&amp;sdata=QqGZvAJ2In9MH1OR%2Bpd74P65mzDy%2F3xRiWxqDog11yw%3D&amp;reserved=0
            [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418293642&amp;sdata=3Nf%2BCKIJlo4x88fl1TAFBNqQ1Yg4%2BsVpI2n2Mq1Dd30%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418293642&amp;sdata=5yXQiFvdKDKrlVbuH%2BW%2BzUurLD7NNSiXoCraOdklufU%3D&amp;reserved=0>
            [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418293642&amp;sdata=XSgjAj%2Bs4RABFx4bFT8tpiC1wlXf04ze9bt2RdTIFho%3D&amp;reserved=0
    
            From: Yishay Weiss<ma...@hotmail.com>
            Sent: Monday, February 3, 2020 2:57 PM
            To: dev@royale.apache.org<ma...@royale.apache.org>
            Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
            Subject: RE: YFiles, EPL, Apache
    
            As promised, here is the summary of my correspondence with yFiles.
    
            > My questions to Sebastian from yWorks:
            >
            > a) Would yWorks allow us to create and publish typedefs (think of them
            > as Royale d.ts files) in our GitHub repository? I would also need to
            > check license issues on the Apache side.
    
            Our license does not allow publishing such files, which would be
            derivative works from files which are currently under our proprietary
            license. Although we could grant you permission to do that, we are
            currently very hesitant to do so. Here's why: Unless there is someone
            who actively maintains these typings, they would quickly become outdated
            because with every new release we add new features and APIs. The only
            way someone could reasonably maintain such a file (about 10k public API
            members, 7 MB TypeScript definition file) would be through a
            (semi-automatic?) conversion process. Thus both from a practical and
            legal perspective it would make a lot more sense to have a tool that
            reads our API definition files and creates the typedefs. Any licensed
            yFiles user could make use of this tool and would always get the
            typedefs matching her yFiles version.
    
            For you reference: This is what someone else did to get yFiles for HTML
            to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418303635&amp;sdata=lULV6HBxMgNMfzBYX9sTiyMszHjnbhZgqdCP1iIrabE%3D&amp;reserved=0
            They got explicit permission from us for this (because they do not
            publish the original files).
    
            >
            > b) Would yWorks consider porting yFiles to Royale?
    
            Yes, if and once we get reasonable amount of feedback and customer
            interest. If you're interested in licensing yFiles for Apache Royale,
            please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418303635&amp;sdata=k0Rcy9aSp6rNV0Vwe9szbW5crWgjZekNETX6GLVYPdY%3D&amp;reserved=0>
            FWIW the vast majoriy of our previous yFiles FLEX customers has
            successfully migrated to "native web" technologies and is now happily
            using yFiles for HTML: With the current state of Apache Royale and the
            web, we don't see that Apache Royale has gained enough traction that
            would justify the efforts.
            We currently believe that creating the diagramming part using "classic"
            TypeScript/JavaScript and wrapping the resulting component up in a small
            Royale component with a tiny API surface is the superios and more
            efficient approach.
    
    
            From: Yishay Weiss<ma...@hotmail.com>
            Sent: Sunday, January 12, 2020 11:37 PM
            To: dev@royale.apache.org<ma...@royale.apache.org>
            Subject: RE: YFiles, EPL, Apache
    
            Ok, I contacted them. I’ll let you guys know.
    
            ________________________________
            From: Carlos Rovira <ca...@apache.org>
            Sent: Sunday, January 12, 2020 6:58:17 PM
            To: dev@royale.apache.org <de...@royale.apache.org>
            Subject: Re: YFiles, EPL, Apache
    
            Hi,
    
            I think you should contact yFiles directly and talk with them about it.
            That's better to try to figure if something could be wrong in the future.
    
            My understanding is that he should be able to give you permission since it
            implies make his commercial lib to clients that want to use in Royale.
            So that clientes will still need to pay for the commercial version, while
            if no typedefs are done, it will be more difficult to do.
    
    
    
            El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
            escribió:
    
            >
            > Hi,
            >
            > Before I start making inquiries in legal I wonder if anyone here can give
            > me some guidance.
            >
            > I want to create typedefs for yFiles [1], using an externs [2] file that’s
            > under an EPL [3]. Should that be a problem?
            >
            > This issue [4] makes me extra cautious.
            >
            > Thanks.
            >
            > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418303635&amp;sdata=qFQidbak8J9KHiwV%2F6UpPf6yYc3J%2BRq9yJSAGkACXmA%3D&amp;reserved=0
            > [2]
            > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418303635&amp;sdata=KmoguurvdgxgUO7e04MWQCDXaECqjfK7WOBz9OOcZVs%3D&amp;reserved=0
            > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418303635&amp;sdata=4r8jUg70%2BGcUeUqzShy4wGvFXs%2FpAZ3pXr%2Fs6n0Gmz4%3D&amp;reserved=0
            > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418303635&amp;sdata=XFsqQcBx2NfbRZR9V2E6cnQd%2Bct0ztfi6rj5G%2B08RhA%3D&amp;reserved=0
            >
    
    
            --
            Carlos Rovira
            https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7Ca9b44f7e3ff8404afe7608d7a91df381%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163818418303635&amp;sdata=cB%2FVpnZiiw%2FDflbN3XQWxlwM0RQ8EUf9uyWYYhJUyAg%3D&amp;reserved=0
    
    
    
    
    
    


Re: YFiles, EPL, Apache

Posted by Yishay Weiss <yi...@hotmail.com>.
Yes, they do have a jsdoc file. Do you think it would be easier to maintain a conversion tool for that?
________________________________
From: Alex Harui <ah...@adobe.com.INVALID>
Sent: Monday, February 3, 2020 8:54:00 PM
To: dev@royale.apache.org <de...@royale.apache.org>
Cc: sebastian.mueller@yworks.com <se...@yworks.com>
Subject: Re: YFiles, EPL, Apache

I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.

-Alex

On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.

    [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=S8a3tJy%2FM9O5K%2BEwy1OXD8isVi8Jx%2BpumUdOV6Tvh%2F8%3D&amp;reserved=0
    [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=lEEJ59%2BegMwPtR3N7Li53NyMuaPa3l6hW4eIu4XT9P4%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=S8a3tJy%2FM9O5K%2BEwy1OXD8isVi8Jx%2BpumUdOV6Tvh%2F8%3D&amp;reserved=0>
    GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=S8a3tJy%2FM9O5K%2BEwy1OXD8isVi8Jx%2BpumUdOV6Tvh%2F8%3D&amp;reserved=0>
    Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
    github.com

    ________________________________
    From: Alex Harui <ah...@adobe.com.INVALID>
    Sent: Monday, February 3, 2020 4:40 PM
    To: dev@royale.apache.org <de...@royale.apache.org>
    Cc: sebastian.mueller@yworks.com <se...@yworks.com>
    Subject: Re: YFiles, EPL, Apache

    I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.

    -Alex

    On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

        Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.

        [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=LkKWOpVhRllDhimwY18ziOfUpCf5s2%2BTZdmt6A4VifE%3D&amp;reserved=0
        [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=%2B%2FdPDDaG2Z2zX4MYqA7k5DRSwG%2F%2BL6p2LSnMXB%2BMFfo%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=HmYcReWjf3ZeitQI0fEEVgEqr7rD6qevp4GFbB0Uq7A%3D&amp;reserved=0>
        [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=dmjtfWV%2FfbxXpO3QeplvfsxuyouzIUNQmkFcXT0QNqg%3D&amp;reserved=0

        From: Yishay Weiss<ma...@hotmail.com>
        Sent: Monday, February 3, 2020 2:57 PM
        To: dev@royale.apache.org<ma...@royale.apache.org>
        Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
        Subject: RE: YFiles, EPL, Apache

        As promised, here is the summary of my correspondence with yFiles.

        > My questions to Sebastian from yWorks:
        >
        > a) Would yWorks allow us to create and publish typedefs (think of them
        > as Royale d.ts files) in our GitHub repository? I would also need to
        > check license issues on the Apache side.

        Our license does not allow publishing such files, which would be
        derivative works from files which are currently under our proprietary
        license. Although we could grant you permission to do that, we are
        currently very hesitant to do so. Here's why: Unless there is someone
        who actively maintains these typings, they would quickly become outdated
        because with every new release we add new features and APIs. The only
        way someone could reasonably maintain such a file (about 10k public API
        members, 7 MB TypeScript definition file) would be through a
        (semi-automatic?) conversion process. Thus both from a practical and
        legal perspective it would make a lot more sense to have a tool that
        reads our API definition files and creates the typedefs. Any licensed
        yFiles user could make use of this tool and would always get the
        typedefs matching her yFiles version.

        For you reference: This is what someone else did to get yFiles for HTML
        to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=05PNnunl1C6U6xoHc9cFzO5OFd3JGncCEj8ee%2F1JKYk%3D&amp;reserved=0
        They got explicit permission from us for this (because they do not
        publish the original files).

        >
        > b) Would yWorks consider porting yFiles to Royale?

        Yes, if and once we get reasonable amount of feedback and customer
        interest. If you're interested in licensing yFiles for Apache Royale,
        please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=OHcIQDLekylpBkf%2BMjo06spqrHJYH2ulNZvMHX7nG0M%3D&amp;reserved=0>
        FWIW the vast majoriy of our previous yFiles FLEX customers has
        successfully migrated to "native web" technologies and is now happily
        using yFiles for HTML: With the current state of Apache Royale and the
        web, we don't see that Apache Royale has gained enough traction that
        would justify the efforts.
        We currently believe that creating the diagramming part using "classic"
        TypeScript/JavaScript and wrapping the resulting component up in a small
        Royale component with a tiny API surface is the superios and more
        efficient approach.


        From: Yishay Weiss<ma...@hotmail.com>
        Sent: Sunday, January 12, 2020 11:37 PM
        To: dev@royale.apache.org<ma...@royale.apache.org>
        Subject: RE: YFiles, EPL, Apache

        Ok, I contacted them. I’ll let you guys know.

        ________________________________
        From: Carlos Rovira <ca...@apache.org>
        Sent: Sunday, January 12, 2020 6:58:17 PM
        To: dev@royale.apache.org <de...@royale.apache.org>
        Subject: Re: YFiles, EPL, Apache

        Hi,

        I think you should contact yFiles directly and talk with them about it.
        That's better to try to figure if something could be wrong in the future.

        My understanding is that he should be able to give you permission since it
        implies make his commercial lib to clients that want to use in Royale.
        So that clientes will still need to pay for the commercial version, while
        if no typedefs are done, it will be more difficult to do.



        El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
        escribió:

        >
        > Hi,
        >
        > Before I start making inquiries in legal I wonder if anyone here can give
        > me some guidance.
        >
        > I want to create typedefs for yFiles [1], using an externs [2] file that’s
        > under an EPL [3]. Should that be a problem?
        >
        > This issue [4] makes me extra cautious.
        >
        > Thanks.
        >
        > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=k2iYKC9m7%2Fw8b7wG2hEMlQ5WcqIAdcTWql3uNi83ODQ%3D&amp;reserved=0
        > [2]
        > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=RMtRAJjnwVyuSaM1Q9QN8Hz0jCORZ%2F5ffY3Eo88Y20I%3D&amp;reserved=0
        > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=q7rUio8m8iO0JMyzmFZhWyuG0JN2v2LJ7CwqQW%2F%2BLCI%3D&amp;reserved=0
        > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736549147&amp;sdata=DN46YYsaZEAUEP%2FNJ5zAz6%2B%2BcH1OIfJoMJBKJSmy2Bw%3D&amp;reserved=0
        >


        --
        Carlos Rovira
        https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736549147&amp;sdata=INsS3nuM%2F8cpZnL1auYppnUbdyaln57phNzJXpEuD64%3D&amp;reserved=0






Re: YFiles, EPL, Apache

Posted by Alex Harui <ah...@adobe.com.INVALID>.
I think I'm missing something.  Sebastian seemed to be saying there is a JSDoc-annotated Javascript file that YFiles maintains.  Josh's tool was for d.ts files.   If the JSDoc JS file is compatible with Google Closure's format, we might be able to consume that.

-Alex 

On 2/3/20, 11:51 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.
    
    [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=S8a3tJy%2FM9O5K%2BEwy1OXD8isVi8Jx%2BpumUdOV6Tvh%2F8%3D&amp;reserved=0
    [https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Favatars3.githubusercontent.com%2Fu%2F13039185%3Fs%3D400%26v%3D4&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=lEEJ59%2BegMwPtR3N7Li53NyMuaPa3l6hW4eIu4XT9P4%3D&amp;reserved=0]<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=S8a3tJy%2FM9O5K%2BEwy1OXD8isVi8Jx%2BpumUdOV6Tvh%2F8%3D&amp;reserved=0>
    GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FBowlerHatLLC%2Fdts2as&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=S8a3tJy%2FM9O5K%2BEwy1OXD8isVi8Jx%2BpumUdOV6Tvh%2F8%3D&amp;reserved=0>
    Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
    github.com
    
    ________________________________
    From: Alex Harui <ah...@adobe.com.INVALID>
    Sent: Monday, February 3, 2020 4:40 PM
    To: dev@royale.apache.org <de...@royale.apache.org>
    Cc: sebastian.mueller@yworks.com <se...@yworks.com>
    Subject: Re: YFiles, EPL, Apache
    
    I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.
    
    -Alex
    
    On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
    
        Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.
    
        [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736529155&amp;sdata=LkKWOpVhRllDhimwY18ziOfUpCf5s2%2BTZdmt6A4VifE%3D&amp;reserved=0
        [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=%2B%2FdPDDaG2Z2zX4MYqA7k5DRSwG%2F%2BL6p2LSnMXB%2BMFfo%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=HmYcReWjf3ZeitQI0fEEVgEqr7rD6qevp4GFbB0Uq7A%3D&amp;reserved=0>
        [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=dmjtfWV%2FfbxXpO3QeplvfsxuyouzIUNQmkFcXT0QNqg%3D&amp;reserved=0
    
        From: Yishay Weiss<ma...@hotmail.com>
        Sent: Monday, February 3, 2020 2:57 PM
        To: dev@royale.apache.org<ma...@royale.apache.org>
        Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
        Subject: RE: YFiles, EPL, Apache
    
        As promised, here is the summary of my correspondence with yFiles.
    
        > My questions to Sebastian from yWorks:
        >
        > a) Would yWorks allow us to create and publish typedefs (think of them
        > as Royale d.ts files) in our GitHub repository? I would also need to
        > check license issues on the Apache side.
    
        Our license does not allow publishing such files, which would be
        derivative works from files which are currently under our proprietary
        license. Although we could grant you permission to do that, we are
        currently very hesitant to do so. Here's why: Unless there is someone
        who actively maintains these typings, they would quickly become outdated
        because with every new release we add new features and APIs. The only
        way someone could reasonably maintain such a file (about 10k public API
        members, 7 MB TypeScript definition file) would be through a
        (semi-automatic?) conversion process. Thus both from a practical and
        legal perspective it would make a lot more sense to have a tool that
        reads our API definition files and creates the typedefs. Any licensed
        yFiles user could make use of this tool and would always get the
        typedefs matching her yFiles version.
    
        For you reference: This is what someone else did to get yFiles for HTML
        to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=05PNnunl1C6U6xoHc9cFzO5OFd3JGncCEj8ee%2F1JKYk%3D&amp;reserved=0
        They got explicit permission from us for this (because they do not
        publish the original files).
    
        >
        > b) Would yWorks consider porting yFiles to Royale?
    
        Yes, if and once we get reasonable amount of feedback and customer
        interest. If you're interested in licensing yFiles for Apache Royale,
        please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=OHcIQDLekylpBkf%2BMjo06spqrHJYH2ulNZvMHX7nG0M%3D&amp;reserved=0>
        FWIW the vast majoriy of our previous yFiles FLEX customers has
        successfully migrated to "native web" technologies and is now happily
        using yFiles for HTML: With the current state of Apache Royale and the
        web, we don't see that Apache Royale has gained enough traction that
        would justify the efforts.
        We currently believe that creating the diagramming part using "classic"
        TypeScript/JavaScript and wrapping the resulting component up in a small
        Royale component with a tiny API surface is the superios and more
        efficient approach.
    
    
        From: Yishay Weiss<ma...@hotmail.com>
        Sent: Sunday, January 12, 2020 11:37 PM
        To: dev@royale.apache.org<ma...@royale.apache.org>
        Subject: RE: YFiles, EPL, Apache
    
        Ok, I contacted them. I’ll let you guys know.
    
        ________________________________
        From: Carlos Rovira <ca...@apache.org>
        Sent: Sunday, January 12, 2020 6:58:17 PM
        To: dev@royale.apache.org <de...@royale.apache.org>
        Subject: Re: YFiles, EPL, Apache
    
        Hi,
    
        I think you should contact yFiles directly and talk with them about it.
        That's better to try to figure if something could be wrong in the future.
    
        My understanding is that he should be able to give you permission since it
        implies make his commercial lib to clients that want to use in Royale.
        So that clientes will still need to pay for the commercial version, while
        if no typedefs are done, it will be more difficult to do.
    
    
    
        El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
        escribió:
    
        >
        > Hi,
        >
        > Before I start making inquiries in legal I wonder if anyone here can give
        > me some guidance.
        >
        > I want to create typedefs for yFiles [1], using an externs [2] file that’s
        > under an EPL [3]. Should that be a problem?
        >
        > This issue [4] makes me extra cautious.
        >
        > Thanks.
        >
        > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=k2iYKC9m7%2Fw8b7wG2hEMlQ5WcqIAdcTWql3uNi83ODQ%3D&amp;reserved=0
        > [2]
        > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=RMtRAJjnwVyuSaM1Q9QN8Hz0jCORZ%2F5ffY3Eo88Y20I%3D&amp;reserved=0
        > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736539152&amp;sdata=q7rUio8m8iO0JMyzmFZhWyuG0JN2v2LJ7CwqQW%2F%2BLCI%3D&amp;reserved=0
        > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736549147&amp;sdata=DN46YYsaZEAUEP%2FNJ5zAz6%2B%2BcH1OIfJoMJBKJSmy2Bw%3D&amp;reserved=0
        >
    
    
        --
        Carlos Rovira
        https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7C8d45570f5f42447e844a08d7a8e26bbd%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163562736549147&amp;sdata=INsS3nuM%2F8cpZnL1auYppnUbdyaln57phNzJXpEuD64%3D&amp;reserved=0
    
    
    
    


Re: YFiles, EPL, Apache

Posted by Yishay Weiss <yi...@hotmail.com>.
Josh had a tool [1] for converting d.ts to typedefs but he said it was a full-time job maintaining it and thus aborted.

[1] https://github.com/BowlerHatLLC/dts2as
[https://avatars3.githubusercontent.com/u/13039185?s=400&v=4]<https://github.com/BowlerHatLLC/dts2as>
GitHub - BowlerHatLLC/dts2as: Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS<https://github.com/BowlerHatLLC/dts2as>
Convert TypeScript definitions (d.ts files) into ActionScript classes and interfaces for use as external libraries with Apache FlexJS - BowlerHatLLC/dts2as
github.com

________________________________
From: Alex Harui <ah...@adobe.com.INVALID>
Sent: Monday, February 3, 2020 4:40 PM
To: dev@royale.apache.org <de...@royale.apache.org>
Cc: sebastian.mueller@yworks.com <se...@yworks.com>
Subject: Re: YFiles, EPL, Apache

I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.

-Alex

On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.

    [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=s4sGRY%2FMI1sD7tXtvBVO5Kh45g3oNaB74uKrkX5ai0Q%3D&amp;reserved=0
    [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=WYfUHb6TGjUd%2FGK54s7rlJ2v%2FsEY2WbDV4lsPjFF56I%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=xnmi6nMw03Cvl7b%2BeWDMjaDjsIJjKjNjn3S0y6IHIIE%3D&amp;reserved=0>
    [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=P8AwMtr3hC2wiFtayeFOBPK2OQphS7fc9fmNVWecQdY%3D&amp;reserved=0

    From: Yishay Weiss<ma...@hotmail.com>
    Sent: Monday, February 3, 2020 2:57 PM
    To: dev@royale.apache.org<ma...@royale.apache.org>
    Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
    Subject: RE: YFiles, EPL, Apache

    As promised, here is the summary of my correspondence with yFiles.

    > My questions to Sebastian from yWorks:
    >
    > a) Would yWorks allow us to create and publish typedefs (think of them
    > as Royale d.ts files) in our GitHub repository? I would also need to
    > check license issues on the Apache side.

    Our license does not allow publishing such files, which would be
    derivative works from files which are currently under our proprietary
    license. Although we could grant you permission to do that, we are
    currently very hesitant to do so. Here's why: Unless there is someone
    who actively maintains these typings, they would quickly become outdated
    because with every new release we add new features and APIs. The only
    way someone could reasonably maintain such a file (about 10k public API
    members, 7 MB TypeScript definition file) would be through a
    (semi-automatic?) conversion process. Thus both from a practical and
    legal perspective it would make a lot more sense to have a tool that
    reads our API definition files and creates the typedefs. Any licensed
    yFiles user could make use of this tool and would always get the
    typedefs matching her yFiles version.

    For you reference: This is what someone else did to get yFiles for HTML
    to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=2YrTh8RbCM2OGg%2F84RcJ8cJTN%2FyRzKILCtg1QS4RAac%3D&amp;reserved=0
    They got explicit permission from us for this (because they do not
    publish the original files).

    >
    > b) Would yWorks consider porting yFiles to Royale?

    Yes, if and once we get reasonable amount of feedback and customer
    interest. If you're interested in licensing yFiles for Apache Royale,
    please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=%2B2oFqyRA%2FgRftJl0k1asIfWa9%2BYmwm2%2FP262AiPO%2FM0%3D&amp;reserved=0>
    FWIW the vast majoriy of our previous yFiles FLEX customers has
    successfully migrated to "native web" technologies and is now happily
    using yFiles for HTML: With the current state of Apache Royale and the
    web, we don't see that Apache Royale has gained enough traction that
    would justify the efforts.
    We currently believe that creating the diagramming part using "classic"
    TypeScript/JavaScript and wrapping the resulting component up in a small
    Royale component with a tiny API surface is the superios and more
    efficient approach.


    From: Yishay Weiss<ma...@hotmail.com>
    Sent: Sunday, January 12, 2020 11:37 PM
    To: dev@royale.apache.org<ma...@royale.apache.org>
    Subject: RE: YFiles, EPL, Apache

    Ok, I contacted them. I’ll let you guys know.

    ________________________________
    From: Carlos Rovira <ca...@apache.org>
    Sent: Sunday, January 12, 2020 6:58:17 PM
    To: dev@royale.apache.org <de...@royale.apache.org>
    Subject: Re: YFiles, EPL, Apache

    Hi,

    I think you should contact yFiles directly and talk with them about it.
    That's better to try to figure if something could be wrong in the future.

    My understanding is that he should be able to give you permission since it
    implies make his commercial lib to clients that want to use in Royale.
    So that clientes will still need to pay for the commercial version, while
    if no typedefs are done, it will be more difficult to do.



    El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
    escribió:

    >
    > Hi,
    >
    > Before I start making inquiries in legal I wonder if anyone here can give
    > me some guidance.
    >
    > I want to create typedefs for yFiles [1], using an externs [2] file that’s
    > under an EPL [3]. Should that be a problem?
    >
    > This issue [4] makes me extra cautious.
    >
    > Thanks.
    >
    > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=Npg5YtRwd5zq%2FWS4j6himOFsks3KQbWtLzT6NWMaa9k%3D&amp;reserved=0
    > [2]
    > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=s4sGRY%2FMI1sD7tXtvBVO5Kh45g3oNaB74uKrkX5ai0Q%3D&amp;reserved=0
    > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=aUYLW%2F8ECnasuSpWTIADvowB0sbpKHvE%2FxQQuD%2B3k3s%3D&amp;reserved=0
    > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=JWYeQW9X%2BvGAeq8yNSafl5Kf7UjvzwDZMVC2hefcpjM%3D&amp;reserved=0
    >


    --
    Carlos Rovira
    https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=SOfL8dXGeOs1PFkmha4JvnARMv5rgOIKgUfOCpEONUQ%3D&amp;reserved=0




Re: YFiles, EPL, Apache

Posted by Carlos Rovira <ca...@apache.org>.
Hi, could be possible to use the Kotlin tool exposed by Sebastian as a
starting point for that tool?

Thanks

El lun., 3 feb. 2020 a las 17:40, Alex Harui (<ah...@adobe.com.invalid>)
escribió:

> I'm wondering what the "API definition files" look like.  Maybe we can
> quickly write a tool to generate the typedefs.
>
> -Alex
>
> On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:
>
>     Sebastian, on the subject of derivative work on public repos, you
> might want to contact the author of this [1] externs file. He has a long
> list of externs files [2] that were derived from around 3 years ago from
> DefinitelyTyped [3]. We would, of course, not be using this [1] in light of
> your constraints on derivative work.
>
>     [1]
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=s4sGRY%2FMI1sD7tXtvBVO5Kh45g3oNaB74uKrkX5ai0Q%3D&amp;reserved=0
>     [2]
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=WYfUHb6TGjUd%2FGK54s7rlJ2v%2FsEY2WbDV4lsPjFF56I%3D&amp;reserved=0
> <
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=xnmi6nMw03Cvl7b%2BeWDMjaDjsIJjKjNjn3S0y6IHIIE%3D&amp;reserved=0
> >
>     [3]
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=P8AwMtr3hC2wiFtayeFOBPK2OQphS7fc9fmNVWecQdY%3D&amp;reserved=0
>
>     From: Yishay Weiss<ma...@hotmail.com>
>     Sent: Monday, February 3, 2020 2:57 PM
>     To: dev@royale.apache.org<ma...@royale.apache.org>
>     Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
>     Subject: RE: YFiles, EPL, Apache
>
>     As promised, here is the summary of my correspondence with yFiles.
>
>     > My questions to Sebastian from yWorks:
>     >
>     > a) Would yWorks allow us to create and publish typedefs (think of
> them
>     > as Royale d.ts files) in our GitHub repository? I would also need to
>     > check license issues on the Apache side.
>
>     Our license does not allow publishing such files, which would be
>     derivative works from files which are currently under our proprietary
>     license. Although we could grant you permission to do that, we are
>     currently very hesitant to do so. Here's why: Unless there is someone
>     who actively maintains these typings, they would quickly become
> outdated
>     because with every new release we add new features and APIs. The only
>     way someone could reasonably maintain such a file (about 10k public API
>     members, 7 MB TypeScript definition file) would be through a
>     (semi-automatic?) conversion process. Thus both from a practical and
>     legal perspective it would make a lot more sense to have a tool that
>     reads our API definition files and creates the typedefs. Any licensed
>     yFiles user could make use of this tool and would always get the
>     typedefs matching her yFiles version.
>
>     For you reference: This is what someone else did to get yFiles for HTML
>     to work seemlessly with Kotlin/JS:
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=2YrTh8RbCM2OGg%2F84RcJ8cJTN%2FyRzKILCtg1QS4RAac%3D&amp;reserved=0
>     They got explicit permission from us for this (because they do not
>     publish the original files).
>
>     >
>     > b) Would yWorks consider porting yFiles to Royale?
>
>     Yes, if and once we get reasonable amount of feedback and customer
>     interest. If you're interested in licensing yFiles for Apache Royale,
>     please do state so and/or contact our support team:
> yworks.com/contact<
> https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=%2B2oFqyRA%2FgRftJl0k1asIfWa9%2BYmwm2%2FP262AiPO%2FM0%3D&amp;reserved=0
> >
>     FWIW the vast majoriy of our previous yFiles FLEX customers has
>     successfully migrated to "native web" technologies and is now happily
>     using yFiles for HTML: With the current state of Apache Royale and the
>     web, we don't see that Apache Royale has gained enough traction that
>     would justify the efforts.
>     We currently believe that creating the diagramming part using "classic"
>     TypeScript/JavaScript and wrapping the resulting component up in a
> small
>     Royale component with a tiny API surface is the superios and more
>     efficient approach.
>
>
>     From: Yishay Weiss<ma...@hotmail.com>
>     Sent: Sunday, January 12, 2020 11:37 PM
>     To: dev@royale.apache.org<ma...@royale.apache.org>
>     Subject: RE: YFiles, EPL, Apache
>
>     Ok, I contacted them. I’ll let you guys know.
>
>     ________________________________
>     From: Carlos Rovira <ca...@apache.org>
>     Sent: Sunday, January 12, 2020 6:58:17 PM
>     To: dev@royale.apache.org <de...@royale.apache.org>
>     Subject: Re: YFiles, EPL, Apache
>
>     Hi,
>
>     I think you should contact yFiles directly and talk with them about it.
>     That's better to try to figure if something could be wrong in the
> future.
>
>     My understanding is that he should be able to give you permission
> since it
>     implies make his commercial lib to clients that want to use in Royale.
>     So that clientes will still need to pay for the commercial version,
> while
>     if no typedefs are done, it will be more difficult to do.
>
>
>
>     El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<
> yishayjobs@hotmail.com>)
>     escribió:
>
>     >
>     > Hi,
>     >
>     > Before I start making inquiries in legal I wonder if anyone here can
> give
>     > me some guidance.
>     >
>     > I want to create typedefs for yFiles [1], using an externs [2] file
> that’s
>     > under an EPL [3]. Should that be a problem?
>     >
>     > This issue [4] makes me extra cautious.
>     >
>     > Thanks.
>     >
>     > [1]
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=Npg5YtRwd5zq%2FWS4j6himOFsks3KQbWtLzT6NWMaa9k%3D&amp;reserved=0
>     > [2]
>     >
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=s4sGRY%2FMI1sD7tXtvBVO5Kh45g3oNaB74uKrkX5ai0Q%3D&amp;reserved=0
>     > [3]
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=aUYLW%2F8ECnasuSpWTIADvowB0sbpKHvE%2FxQQuD%2B3k3s%3D&amp;reserved=0
>     > [4]
> https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=JWYeQW9X%2BvGAeq8yNSafl5Kf7UjvzwDZMVC2hefcpjM%3D&amp;reserved=0
>     >
>
>
>     --
>     Carlos Rovira
>
> https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=SOfL8dXGeOs1PFkmha4JvnARMv5rgOIKgUfOCpEONUQ%3D&amp;reserved=0
>
>
>
>

-- 
Carlos Rovira
http://about.me/carlosrovira

Re: YFiles, EPL, Apache

Posted by Alex Harui <ah...@adobe.com.INVALID>.
I'm wondering what the "API definition files" look like.  Maybe we can quickly write a tool to generate the typedefs.

-Alex

On 2/3/20, 5:07 AM, "Yishay Weiss" <yi...@hotmail.com> wrote:

    Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.
    
    [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=s4sGRY%2FMI1sD7tXtvBVO5Kh45g3oNaB74uKrkX5ai0Q%3D&amp;reserved=0
    [2] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Ftree%2Fmaster%2Fexterns&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=WYfUHb6TGjUd%2FGK54s7rlJ2v%2FsEY2WbDV4lsPjFF56I%3D&amp;reserved=0<https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=xnmi6nMw03Cvl7b%2BeWDMjaDjsIJjKjNjn3S0y6IHIIE%3D&amp;reserved=0>
    [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=P8AwMtr3hC2wiFtayeFOBPK2OQphS7fc9fmNVWecQdY%3D&amp;reserved=0
    
    From: Yishay Weiss<ma...@hotmail.com>
    Sent: Monday, February 3, 2020 2:57 PM
    To: dev@royale.apache.org<ma...@royale.apache.org>
    Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
    Subject: RE: YFiles, EPL, Apache
    
    As promised, here is the summary of my correspondence with yFiles.
    
    > My questions to Sebastian from yWorks:
    >
    > a) Would yWorks allow us to create and publish typedefs (think of them
    > as Royale d.ts files) in our GitHub repository? I would also need to
    > check license issues on the Apache side.
    
    Our license does not allow publishing such files, which would be
    derivative works from files which are currently under our proprietary
    license. Although we could grant you permission to do that, we are
    currently very hesitant to do so. Here's why: Unless there is someone
    who actively maintains these typings, they would quickly become outdated
    because with every new release we add new features and APIs. The only
    way someone could reasonably maintain such a file (about 10k public API
    members, 7 MB TypeScript definition file) would be through a
    (semi-automatic?) conversion process. Thus both from a practical and
    legal perspective it would make a lot more sense to have a tool that
    reads our API definition files and creates the typedefs. Any licensed
    yFiles user could make use of this tool and would always get the
    typedefs matching her yFiles version.
    
    For you reference: This is what someone else did to get yFiles for HTML
    to work seemlessly with Kotlin/JS: https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fturansky%2Fyfiles-kotlin&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=2YrTh8RbCM2OGg%2F84RcJ8cJTN%2FyRzKILCtg1QS4RAac%3D&amp;reserved=0
    They got explicit permission from us for this (because they do not
    publish the original files).
    
    >
    > b) Would yWorks consider porting yFiles to Royale?
    
    Yes, if and once we get reasonable amount of feedback and customer
    interest. If you're interested in licensing yFiles for Apache Royale,
    please do state so and/or contact our support team:  yworks.com/contact<https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fyworks.com%2Fcontact&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=%2B2oFqyRA%2FgRftJl0k1asIfWa9%2BYmwm2%2FP262AiPO%2FM0%3D&amp;reserved=0>
    FWIW the vast majoriy of our previous yFiles FLEX customers has
    successfully migrated to "native web" technologies and is now happily
    using yFiles for HTML: With the current state of Apache Royale and the
    web, we don't see that Apache Royale has gained enough traction that
    would justify the efforts.
    We currently believe that creating the diagramming part using "classic"
    TypeScript/JavaScript and wrapping the resulting component up in a small
    Royale component with a tiny API surface is the superios and more
    efficient approach.
    
    
    From: Yishay Weiss<ma...@hotmail.com>
    Sent: Sunday, January 12, 2020 11:37 PM
    To: dev@royale.apache.org<ma...@royale.apache.org>
    Subject: RE: YFiles, EPL, Apache
    
    Ok, I contacted them. I’ll let you guys know.
    
    ________________________________
    From: Carlos Rovira <ca...@apache.org>
    Sent: Sunday, January 12, 2020 6:58:17 PM
    To: dev@royale.apache.org <de...@royale.apache.org>
    Subject: Re: YFiles, EPL, Apache
    
    Hi,
    
    I think you should contact yFiles directly and talk with them about it.
    That's better to try to figure if something could be wrong in the future.
    
    My understanding is that he should be able to give you permission since it
    implies make his commercial lib to clients that want to use in Royale.
    So that clientes will still need to pay for the commercial version, while
    if no typedefs are done, it will be more difficult to do.
    
    
    
    El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
    escribió:
    
    >
    > Hi,
    >
    > Before I start making inquiries in legal I wonder if anyone here can give
    > me some guidance.
    >
    > I want to create typedefs for yFiles [1], using an externs [2] file that’s
    > under an EPL [3]. Should that be a problem?
    >
    > This issue [4] makes me extra cautious.
    >
    > Thanks.
    >
    > [1] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.yworks.com%2Fproducts%2Fyfiles-for-html&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=Npg5YtRwd5zq%2FWS4j6himOFsks3KQbWtLzT6NWMaa9k%3D&amp;reserved=0
    > [2]
    > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fhonzabrecka%2Fts-to-goog%2Fmaster%2Fexterns%2Fyfiles.extern.js&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=s4sGRY%2FMI1sD7tXtvBVO5Kh45g3oNaB74uKrkX5ai0Q%3D&amp;reserved=0
    > [3] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fhonzabrecka%2Fts-to-goog%2Fblob%2Fmaster%2FLICENSE&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=aUYLW%2F8ECnasuSpWTIADvowB0sbpKHvE%2FxQQuD%2B3k3s%3D&amp;reserved=0
    > [4] https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FDefinitelyTyped%2FDefinitelyTyped%2Fissues%2F23310&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=JWYeQW9X%2BvGAeq8yNSafl5Kf7UjvzwDZMVC2hefcpjM%3D&amp;reserved=0
    >
    
    
    --
    Carlos Rovira
    https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&amp;data=02%7C01%7Caharui%40adobe.com%7C66186391c530443d461a08d7a8aa063c%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637163320511043981&amp;sdata=SOfL8dXGeOs1PFkmha4JvnARMv5rgOIKgUfOCpEONUQ%3D&amp;reserved=0
    
    


RE: YFiles, EPL, Apache

Posted by Yishay Weiss <yi...@hotmail.com>.
Sebastian, on the subject of derivative work on public repos, you might want to contact the author of this [1] externs file. He has a long list of externs files [2] that were derived from around 3 years ago from DefinitelyTyped [3]. We would, of course, not be using this [1] in light of your constraints on derivative work.

[1] https://raw.githubusercontent.com/honzabrecka/ts-to-goog/master/externs/yfiles.extern.js
[2] https://github.com/honzabrecka/ts-to-goog/tree/master/externs<https://github.com/honzabrecka/ts-to-goog>
[3] https://github.com/DefinitelyTyped/DefinitelyTyped

From: Yishay Weiss<ma...@hotmail.com>
Sent: Monday, February 3, 2020 2:57 PM
To: dev@royale.apache.org<ma...@royale.apache.org>
Cc: sebastian.mueller@yworks.com<ma...@yworks.com>
Subject: RE: YFiles, EPL, Apache

As promised, here is the summary of my correspondence with yFiles.

> My questions to Sebastian from yWorks:
>
> a) Would yWorks allow us to create and publish typedefs (think of them
> as Royale d.ts files) in our GitHub repository? I would also need to
> check license issues on the Apache side.

Our license does not allow publishing such files, which would be
derivative works from files which are currently under our proprietary
license. Although we could grant you permission to do that, we are
currently very hesitant to do so. Here's why: Unless there is someone
who actively maintains these typings, they would quickly become outdated
because with every new release we add new features and APIs. The only
way someone could reasonably maintain such a file (about 10k public API
members, 7 MB TypeScript definition file) would be through a
(semi-automatic?) conversion process. Thus both from a practical and
legal perspective it would make a lot more sense to have a tool that
reads our API definition files and creates the typedefs. Any licensed
yFiles user could make use of this tool and would always get the
typedefs matching her yFiles version.

For you reference: This is what someone else did to get yFiles for HTML
to work seemlessly with Kotlin/JS: https://github.com/turansky/yfiles-kotlin
They got explicit permission from us for this (because they do not
publish the original files).

>
> b) Would yWorks consider porting yFiles to Royale?

Yes, if and once we get reasonable amount of feedback and customer
interest. If you're interested in licensing yFiles for Apache Royale,
please do state so and/or contact our support team:  yworks.com/contact<http://yworks.com/contact>
FWIW the vast majoriy of our previous yFiles FLEX customers has
successfully migrated to "native web" technologies and is now happily
using yFiles for HTML: With the current state of Apache Royale and the
web, we don't see that Apache Royale has gained enough traction that
would justify the efforts.
We currently believe that creating the diagramming part using "classic"
TypeScript/JavaScript and wrapping the resulting component up in a small
Royale component with a tiny API surface is the superios and more
efficient approach.


From: Yishay Weiss<ma...@hotmail.com>
Sent: Sunday, January 12, 2020 11:37 PM
To: dev@royale.apache.org<ma...@royale.apache.org>
Subject: RE: YFiles, EPL, Apache

Ok, I contacted them. I’ll let you guys know.

________________________________
From: Carlos Rovira <ca...@apache.org>
Sent: Sunday, January 12, 2020 6:58:17 PM
To: dev@royale.apache.org <de...@royale.apache.org>
Subject: Re: YFiles, EPL, Apache

Hi,

I think you should contact yFiles directly and talk with them about it.
That's better to try to figure if something could be wrong in the future.

My understanding is that he should be able to give you permission since it
implies make his commercial lib to clients that want to use in Royale.
So that clientes will still need to pay for the commercial version, while
if no typedefs are done, it will be more difficult to do.



El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
escribió:

>
> Hi,
>
> Before I start making inquiries in legal I wonder if anyone here can give
> me some guidance.
>
> I want to create typedefs for yFiles [1], using an externs [2] file that’s
> under an EPL [3]. Should that be a problem?
>
> This issue [4] makes me extra cautious.
>
> Thanks.
>
> [1] https://www.yworks.com/products/yfiles-for-html
> [2]
> https://raw.githubusercontent.com/honzabrecka/ts-to-goog/master/externs/yfiles.extern.js
> [3] https://github.com/honzabrecka/ts-to-goog/blob/master/LICENSE
> [4] https://github.com/DefinitelyTyped/DefinitelyTyped/issues/23310
>


--
Carlos Rovira
http://about.me/carlosrovira


RE: YFiles, EPL, Apache

Posted by Yishay Weiss <yi...@hotmail.com>.
As promised, here is the summary of my correspondence with yFiles.

> My questions to Sebastian from yWorks:
>
> a) Would yWorks allow us to create and publish typedefs (think of them
> as Royale d.ts files) in our GitHub repository? I would also need to
> check license issues on the Apache side.

Our license does not allow publishing such files, which would be
derivative works from files which are currently under our proprietary
license. Although we could grant you permission to do that, we are
currently very hesitant to do so. Here's why: Unless there is someone
who actively maintains these typings, they would quickly become outdated
because with every new release we add new features and APIs. The only
way someone could reasonably maintain such a file (about 10k public API
members, 7 MB TypeScript definition file) would be through a
(semi-automatic?) conversion process. Thus both from a practical and
legal perspective it would make a lot more sense to have a tool that
reads our API definition files and creates the typedefs. Any licensed
yFiles user could make use of this tool and would always get the
typedefs matching her yFiles version.

For you reference: This is what someone else did to get yFiles for HTML
to work seemlessly with Kotlin/JS: https://github.com/turansky/yfiles-kotlin
They got explicit permission from us for this (because they do not
publish the original files).

>
> b) Would yWorks consider porting yFiles to Royale?

Yes, if and once we get reasonable amount of feedback and customer
interest. If you're interested in licensing yFiles for Apache Royale,
please do state so and/or contact our support team:  yworks.com/contact<http://yworks.com/contact>
FWIW the vast majoriy of our previous yFiles FLEX customers has
successfully migrated to "native web" technologies and is now happily
using yFiles for HTML: With the current state of Apache Royale and the
web, we don't see that Apache Royale has gained enough traction that
would justify the efforts.
We currently believe that creating the diagramming part using "classic"
TypeScript/JavaScript and wrapping the resulting component up in a small
Royale component with a tiny API surface is the superios and more
efficient approach.


From: Yishay Weiss<ma...@hotmail.com>
Sent: Sunday, January 12, 2020 11:37 PM
To: dev@royale.apache.org<ma...@royale.apache.org>
Subject: RE: YFiles, EPL, Apache

Ok, I contacted them. I’ll let you guys know.

________________________________
From: Carlos Rovira <ca...@apache.org>
Sent: Sunday, January 12, 2020 6:58:17 PM
To: dev@royale.apache.org <de...@royale.apache.org>
Subject: Re: YFiles, EPL, Apache

Hi,

I think you should contact yFiles directly and talk with them about it.
That's better to try to figure if something could be wrong in the future.

My understanding is that he should be able to give you permission since it
implies make his commercial lib to clients that want to use in Royale.
So that clientes will still need to pay for the commercial version, while
if no typedefs are done, it will be more difficult to do.



El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
escribió:

>
> Hi,
>
> Before I start making inquiries in legal I wonder if anyone here can give
> me some guidance.
>
> I want to create typedefs for yFiles [1], using an externs [2] file that’s
> under an EPL [3]. Should that be a problem?
>
> This issue [4] makes me extra cautious.
>
> Thanks.
>
> [1] https://www.yworks.com/products/yfiles-for-html
> [2]
> https://raw.githubusercontent.com/honzabrecka/ts-to-goog/master/externs/yfiles.extern.js
> [3] https://github.com/honzabrecka/ts-to-goog/blob/master/LICENSE
> [4] https://github.com/DefinitelyTyped/DefinitelyTyped/issues/23310
>


--
Carlos Rovira
http://about.me/carlosrovira


RE: YFiles, EPL, Apache

Posted by Yishay Weiss <yi...@hotmail.com>.
Ok, I contacted them. I’ll let you guys know.

________________________________
From: Carlos Rovira <ca...@apache.org>
Sent: Sunday, January 12, 2020 6:58:17 PM
To: dev@royale.apache.org <de...@royale.apache.org>
Subject: Re: YFiles, EPL, Apache

Hi,

I think you should contact yFiles directly and talk with them about it.
That's better to try to figure if something could be wrong in the future.

My understanding is that he should be able to give you permission since it
implies make his commercial lib to clients that want to use in Royale.
So that clientes will still need to pay for the commercial version, while
if no typedefs are done, it will be more difficult to do.



El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
escribió:

>
> Hi,
>
> Before I start making inquiries in legal I wonder if anyone here can give
> me some guidance.
>
> I want to create typedefs for yFiles [1], using an externs [2] file that’s
> under an EPL [3]. Should that be a problem?
>
> This issue [4] makes me extra cautious.
>
> Thanks.
>
> [1] https://www.yworks.com/products/yfiles-for-html
> [2]
> https://raw.githubusercontent.com/honzabrecka/ts-to-goog/master/externs/yfiles.extern.js
> [3] https://github.com/honzabrecka/ts-to-goog/blob/master/LICENSE
> [4] https://github.com/DefinitelyTyped/DefinitelyTyped/issues/23310
>


--
Carlos Rovira
http://about.me/carlosrovira

Re: YFiles, EPL, Apache

Posted by Carlos Rovira <ca...@apache.org>.
Hi,

I think you should contact yFiles directly and talk with them about it.
That's better to try to figure if something could be wrong in the future.

My understanding is that he should be able to give you permission since it
implies make his commercial lib to clients that want to use in Royale.
So that clientes will still need to pay for the commercial version, while
if no typedefs are done, it will be more difficult to do.



El dom., 12 ene. 2020 a las 16:30, Yishay Weiss (<yi...@hotmail.com>)
escribió:

>
> Hi,
>
> Before I start making inquiries in legal I wonder if anyone here can give
> me some guidance.
>
> I want to create typedefs for yFiles [1], using an externs [2] file that’s
> under an EPL [3]. Should that be a problem?
>
> This issue [4] makes me extra cautious.
>
> Thanks.
>
> [1] https://www.yworks.com/products/yfiles-for-html
> [2]
> https://raw.githubusercontent.com/honzabrecka/ts-to-goog/master/externs/yfiles.extern.js
> [3] https://github.com/honzabrecka/ts-to-goog/blob/master/LICENSE
> [4] https://github.com/DefinitelyTyped/DefinitelyTyped/issues/23310
>


-- 
Carlos Rovira
http://about.me/carlosrovira