For folks using Storyboard for their upcoming talk...

# storyboard

[rahulrav]

For folks using Storyboard for their upcoming talks:
I recently introduced a new module storyboard-warp that provides a completely new implementation for magic move style animations for code snippets. It should just work.
If you want to give that a try, an example is: github.com/bnorm/storyboard/blob/…/WarpScene.kt#…

The higher level APIs still need some work, (my compose skills are meh at best). But, the core APIs are pretty solid. If you run into anything odd, please let me know !

[curioustechizen]

I'm a huge fan of Storyboard. I could not use it for my previous talk because it had SQL snippets in addition to Kotlin. My next talk will have JSON and Protobuf snippets.

In your PR for Warp I see you mention registering custom languages. Does this mean that storyboard now supports other languages?

[curioustechizen]

Hmm from this it looks like it supports languages supported by IntelliJ
https://github.com/bnorm/storyboard/blob/main/storyboard-warp/src/commonTest/kotlin/com/bnorm/storyboard/HeckelDiffTest.kt

[rahulrav]

It has support for arbitrary languages

[rahulrav]

Just bring your own Textmate grammar

[rahulrav]

I should add an example for that, but that's one of the nice things about this change

[rahulrav]

The @Language annotation that you are probably looking at and are confused about is just for the IDE to make things look nicer when writing the code in the editor

[rahulrav]

https://github.com/bnorm/storyboard/blob/main/storyboard-warp%2Fsrc%2FcommonMain%2Fkotlin%2Fdev%2Fbnorm%2Fstoryboard%2FLanguage.kt#L36

[curioustechizen]

I got protobuf working with warp. These comments were very helpful.
https://github.com/bnorm/storyboard/blob/475595235f44282b205e47da926c60fbd137a1c0/storyboard-warp/src/jvmMain/kotlin/dev/bnorm/storyboard/Parser.jvm.kt#L83

[rahulrav]

Awesome 😎

[curioustechizen]

Should I open a PR? Or is it expected that people using custom languages will use local copies instead?
I worry that if too many languages are added then the LanguageRegistry file in wasmJsMain might get out of hand (all textmate grammars are currently stored as strings in that file).

@bnorm how do you view the topic of additional language support in storyboard?

[rahulrav]

I think we should just move from resources to string files that can be shared between wasmJs and jvmMain

[rahulrav]

Apart from that it can all be done in userland to be honest.

[bnorm]

I'm okay with adding additional supported languages directly to Storyboard. Feel free to open a PR. However, here are some thoughts about this topic in general:

https://kotlinlang.slack.com/archives/C08R5V4EHDH/p1788898163883289

[curioustechizen]

Sorry I think I caused some confusion here. Just to clarify: I only got protobuf working in storyboard-warp, not in storyboard itself.

[bnorm]

No confusion, just wanted to provide some context to my thoughts on these utility libraries in general.

I often see the opinion that Storyboard needs to provide something to be usable (syntax highlighting is a common occurrence, so nothing is directed at you). But often these things are not Storyboard specific and exist outside of Storyboard. Storyboard includes some utilities, but they are by no means meant to be exhaustive or exclusive. Use whatever you want/can!