<div dir="auto">Here’s what I’ve concluded as an observer:</div><div dir="auto"><br></div><div dir="auto">Note that angle brackets <> classes (generics) and things like “any” are specific to TypeScript, but most “TypeScript class” stuff has JavaScript classes or functions which create instances at the core. All TypeScript classes are representable in JavaScript, but without type safety. Type annotations are erased during transpilation. AFAIK, with JSdoc, nothing is erased, there’s no transpilation step.</div><div dir="auto"><br></div><div dir="auto">We should focus on complete, portable implementation of existing JavaScript SAI before piling on more. Like being able to import X_ITE SAI and/or X3DOM SAI into a variable, and the rest of the code would just work using that variable. No difference between external and internal SAI.</div><div dir="auto"><br></div><div dir="auto">It might be worth adding generics to X3D SAI, like the C++ SAI. I’d say tackle that language first, if not done elsewhere. AFAIK, the architecture standard already includes that with type and acceptableTypes (see X3DUOM).</div><div dir="auto"><br></div><div dir="auto">But any SAI work is next year. I’m hoping to see changes in SAI such that setter and adders return self/this. This hopefully will affect Castle which will allow X3D JSON to Pascal conversion without a huge variant type. I’ve also got in the back of my mind to load X3D JSON into Pascal, which would be less disruptive.</div><div dir="auto"><br></div><div dir="auto">I’ve added basic TypeScript type annotations to X3DJSONLD.ts, but I didn’t see much benefit. But I only used the most basic types.</div><div dir="auto"><br></div><div dir="auto">Adding types after the fact is a big pain in the neck. Adding JSDoc after the fact is just plain better and doesn’t mean you have to mess with existing, working functions, one just adds comments.</div><div dir="auto"><br></div><div dir="auto">Otherwise wholesale generation of an API, at least the skin with JavaScript and JSDoc and not TypeScript is possible, but I’d rather focus on adding rendering to X3DJSAIL.</div><div dir="auto"><br></div><div dir="auto">John</div><div><br><div class="gmail_quote gmail_quote_container"><div dir="ltr" class="gmail_attr">On Sat, Mar 8, 2025 at 6:45 PM Brutzman, Donald (Don) (CIV) <<a href="mailto:brutzman@nps.edu">brutzman@nps.edu</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;padding-left:1ex;border-left-color:rgb(204,204,204)">
<div dir="ltr">
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
Thanks for asking Joe. John Carlson (copied above) has presented a good case for TypeScript as well. Two answers:</div>
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
<br>
</div>
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
If specialization is wanted, Sure Why Not. </div>
<ul style="margin-top:0px;margin-bottom:0px">
<li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;list-style-type:"- ";color:rgb(0,0,0)">
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">The X in X3D is extensible. Have fun with extensibility!</div>
</li><li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;list-style-type:"- ";color:rgb(0,0,0)">
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">There are multiple open-source browser solutions out there. Somebody could add TypeScript to an implementation for testing.</div>
</li><li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;list-style-type:"- ";color:rgb(0,0,0)">
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">Somebody could add Typescript classes matching the SAI and X3DUOM (perhaps similar to X3DJSAIL and X3DPSAIL x3d.py). Though I'd think we need to get that done for EcmaScript/JavaScript first, or versionitis might result.</div>
</li><li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;list-style-type:"- ";color:rgb(0,0,0)">
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">Appears possible to author in TypeScript and convert to EcmaScript/JavaScript. From
<a href="https://www.typescriptlang.org" target="_blank" style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">https://www.typescriptlang.org</a></div>
</li><ul style="margin-top:0px;margin-bottom:0px;list-style-type:circle">
<li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">"TypeScript code converts to JavaScript, which <b style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">runs anywhere JavaScript runs</b>: In a browser, on Node.js, Deno, Bun and in your apps."</div>
</li></ul>
</ul>
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
<br>
</div>
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
If standardization is wanted, Not Anytime Soon.</div>
<ul style="margin-top:0px;margin-bottom:0px">
<li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;list-style-type:"- ";color:rgb(0,0,0)">
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">Dick Puk and I have our hands full upgrading all existing specs to match X3D 4.0, thank you.</div>
</li><li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;list-style-type:"- ";color:rgb(0,0,0)">
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">X3D Standards Progress <a href="https://www.web3d.org/x3d/progress" target="_blank" style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">
https://www.web3d.org/x3d/progress</a></div>
</li><ul style="margin-top:0px;margin-bottom:0px;list-style-type:circle">
<li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
<div style="text-align:left;text-indent:0px;margin:0px 0px 18px;font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">
<b style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">Stable repeatable progress </b>for users, modelers, and software developers requires the steady evolution of the X3D Graphics and Humanoid Animation (HAnim) International Standards. Web3D Consortium members produce well-written, well-tested specification
documents that define and refine the X3D and HAnim standards as they continue to improve. Onward we go!</div>
</li><li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
<div style="text-align:left;text-indent:0px;margin:0px 0px 18px;font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif">
Our strategy for consolidation of all X3D Specifications to match X3D Architecture version 4.0 is simple:</div>
</li><ul style="margin-top:0px;margin-bottom:0px">
<li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;margin:0px;list-style-type:"\00220e ";color:rgb(0,0,0)">
update all file encodings in 2025, and</li><li style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;margin:0px;list-style-type:"\00220e ";color:rgb(0,0,0)">
update all programming-language bindings in 2026.</li></ul>
</ul>
</ul>
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
<br>
</div>
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
Wishing best progress. Faithfully yours.</div>
<div id="m_-24305629802480278Signature">
<p style="margin:0in;font-family:Calibri,sans-serif;font-size:11pt"><span style="font-family:"Courier New";font-size:9pt"><br>
</span></p>
<p style="margin:0in;font-family:Calibri,sans-serif;font-size:11pt"><span style="font-family:"Courier New";font-size:9pt">all the best, Don</span></p>
<p style="margin:0in;font-family:Calibri,sans-serif;font-size:11pt"><span style="font-family:"Courier New";font-size:9pt">--</span></p>
<p style="margin:0in;font-family:Calibri,sans-serif;font-size:11pt"><span style="font-family:"Courier New";font-size:9pt">Don Brutzman Naval Postgraduate School, Code USW/Br <a href="mailto:brutzman@nps.edu" target="_blank" style="font-family:"Courier New"">brutzman@nps.edu</a></span></p>
<p style="margin:0in;font-family:Calibri,sans-serif;font-size:11pt"><span style="font-family:"Courier New";font-size:9pt">Watkins 270, MOVES Institute, Monterey CA 93943-5000 USA +1.831.656.2149</span></p>
<p style="margin:0in;font-family:Calibri,sans-serif;font-size:11pt"><span style="font-family:"Courier New";font-size:9pt">X3D graphics, virtual worlds, navy robotics <a href="https://faculty.nps.edu/brutzman" target="_blank" style="font-family:"Courier New"">https://faculty.nps.edu/brutzman</a></span></p>
<p style="margin:0in;font-family:Calibri,sans-serif;font-size:11pt"><span style="font-family:"Courier New";font-size:9pt"> </span></p>
</div>
<div id="m_-24305629802480278appendonsend"></div>
<div style="font-family:Aptos,Aptos_EmbeddedFont,Aptos_MSFontService,Calibri,Helvetica,sans-serif;font-size:11pt;color:rgb(0,0,0)">
<br>
</div>
<hr style="display:inline-block;width:98%">
<div id="m_-24305629802480278divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(0,0,0)"><b style="font-family:Calibri,sans-serif">From:</b> x3d-public <<a href="mailto:x3d-public-bounces@web3d.org" target="_blank" style="font-family:Calibri,sans-serif">x3d-public-bounces@web3d.org</a>> on behalf of Joe D Williams via x3d-public <<a href="mailto:x3d-public@web3d.org" target="_blank" style="font-family:Calibri,sans-serif">x3d-public@web3d.org</a>><br>
<b style="font-family:Calibri,sans-serif">Sent:</b> Friday, March 7, 2025 8:45 PM<br>
<b style="font-family:Calibri,sans-serif">To:</b> <a href="mailto:x3d-public@web3d.org" target="_blank" style="font-family:Calibri,sans-serif">x3d-public@web3d.org</a> <<a href="mailto:x3d-public@web3d.org" target="_blank" style="font-family:Calibri,sans-serif">x3d-public@web3d.org</a>><br>
<b style="font-family:Calibri,sans-serif">Cc:</b> Joe D Williams <<a href="mailto:joedwil@earthlink.net" target="_blank" style="font-family:Calibri,sans-serif">joedwil@earthlink.net</a>><br>
<b style="font-family:Calibri,sans-serif">Subject:</b> [x3d-public] typescript?</font>
<div> </div>
</div></div><div dir="ltr">
<div><font size="2" style="color:rgb(0,0,0)"><span style="font-size:11pt">
<div>"TypeScript is a strongly typed programming language that builds on JavaScript, offering features like static typing, classes, and interfaces. "<br>
<br>
Is this typescript a tool for X3D?<br>
<br>
Thanks, <br>
Joe<br>
<br>
_______________________________________________<br>
x3d-public mailing list<br>
<a href="mailto:x3d-public@web3d.org" target="_blank">x3d-public@web3d.org</a><br>
<a href="http://web3d.org/mailman/listinfo/x3d-public_web3d.org" target="_blank">http://web3d.org/mailman/listinfo/x3d-public_web3d.org</a><br>
</div>
</span></font></div>
</div>
</blockquote></div></div>