Upgrade to Pro — share decks privately, control downloads, hide ads and more …

JSRにモジュールを公開するまで/公開してから

 JSRにモジュールを公開するまで/公開してから

JSR(https://jsr.io/) にモジュールを公開するまでに行ったJSRからの要求事項の対応と公開してから行ったJSRのスコアを上げるための対応について

More Decks by 虎の穴ラボ株式会社

Other Decks in Technology

Transcript

  1. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. T

    O R A N O A N A L a b 2024 JSR にモジュールを 公開するまで/公開してから 2024/5/03 JSR Meetup 虎の穴ラボ株式会社 奥谷 一陽
  2. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    自己紹介 奥谷 一陽 所属:虎の穴ラボ株式会社 興味:Deno、TypeScript 最近買ったもの:ガーゼケット X:@okutann88 github:Octo8080X toranoana.deno 主催の1人です
  3. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    アジェンダ - JSRにパッケージを公開するまで - JSRにパッケージを公開してから - 所感/困っていること
  4. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    Thoth - Deno KV の上で構築する全文検索
  5. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開するまで
 

  6. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開するまで - JSRは、http(s)でモジュールを参照することを許してくれない => http://deno.land/x から参照していたモジュールを JSRに置いてあるモジュールに切り替える。
  7. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開するまで - JSRは、/// <reference lib="deno.unstable" /> の記述を許していない => 削除する
  8. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開するまで - JSRは、/// <reference lib="deno.unstable" /> の記述を許していない - Issueを立てて聞いてみた。 https://github.com/jsr-io/jsr/issues/362 =>   deno.json の compilerOptions.lib で記載しよう
  9. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開するまで - slow types のエラーに対応 - エクスポートされる関数/クラス/const/let宣言に明示的な型が必要 - 参照: https://jsr.io/docs/about-slow-types =>型を明示してあげる - 後から気がついたことですが、deno publish に `--allow-slow-types` オプ ションがあるので、一時回避できるそうです。
  10. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    などなど対応して、JSRにモジュール公開!

  11. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開してから

  12. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開してから - ドキュメントサイトを作りました。 https://thoth-doc.deno.dev/
  13. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開してから - JSRスコアを上げる活動 - JSRには、条件を満たすと上げられるスコアがある。 - Readme またはモジュールのドキュメントがある - Readme またはモジュールのドキュメントに例がある - ほとんどのシンボルのドキュメントがある - slow types が使用されていない - 少なくとも 2 つのランタイムが互換性があるとマークされている など
  14. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開してから - JSRスコアを上げる活動 - JSRには、条件を満たすと上げられるスコアがある。 - ほとんどのシンボルのドキュメントがある => JSDocコメントを書く
  15. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開してから - JSRスコアを上げる活動 - JSRには、条件を満たすと上げられるスコアがある。 - ほとんどのシンボルのドキュメントがある =>JSDocコメントを書くとJSRにも反映される JSDoc コメント 書く前
  16. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    JSRにパッケージを公開してから - JSRスコアを上げる活動 - JSRには、条件を満たすと上げられるスコアがある。 - ほとんどのシンボルのドキュメントがある =>JSDocコメントを書くとJSRにも反映される JSDoc コメント 書いた後
  17. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    所感/困っていること 所感 - JSR公開するパッケージの条件としてやって欲しいことが明確にある。 =>やっていないとエラーになる。わかりやすくて良い。 --dry-run を使うと「公開のタイミングで気づく」ということも減るはず - スコアを設定することで、開発者側の資料作成がモチベートされている =>JSRに載っているモジュールのベースラインがキープされていると思う。 困っていること - JSR公開モジュールをDenoとNodeの両対応したいが、Node.jsでのJSR公開モ ジュールの参照がうまくできていない。 =>もし、何かわかる方いたら相談させてください。
  18. Copyright (C) 2023 Toranoana Lab Inc. All Rights Reserved. 2024

    5月15日(水) toranoana.deno #16 開催