Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Js ts controls #2777

Merged
merged 6 commits into from
Jul 3, 2023
Merged

Js ts controls #2777

merged 6 commits into from
Jul 3, 2023

Conversation

HarelM
Copy link
Collaborator

@HarelM HarelM commented Jul 2, 2023

This removed the jsdocs plugin which doesn't help at this point.
It adds the tsdocs plugin but without using it as it reports around 4K warnings :-(
It fixes the docs of all the controls, which look pretty neat!

This PR is against the tsdocs branch obvioudly.

@HarelM HarelM requested review from birkskyum, wipfli and rotu July 2, 2023 20:39
@codecov-commenter
Copy link

Codecov Report

❗ No coverage uploaded for pull request base (jsdocs-tsdocs@933cb5e). Click here to learn what that means.
Patch has no changes to coverable lines.

Additional details and impacted files
@@               Coverage Diff                @@
##             jsdocs-tsdocs    #2777   +/-   ##
================================================
  Coverage                 ?   73.83%           
================================================
  Files                    ?      238           
  Lines                    ?    18963           
  Branches                 ?     4277           
================================================
  Hits                     ?    14001           
  Misses                   ?     4962           
  Partials                 ?        0           

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

Copy link
Member

@birkskyum birkskyum left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this stack is working really well

@birkskyum
Copy link
Member

birkskyum commented Jul 2, 2023

It seems like the inheritDoc's was supposed to be automatically added for the methods implementing an interface (TypeStrong/typedoc#1498), but I can confirm that it unfortunately doesn't work if they are removed. Adding the @inheritdoc with a lowercase d and without the braces and the name of the referenced function does also work, but even though it's simpler it's jsdoc rather than tsdoc syntax, so what is in the PR now is probably best.

@HarelM HarelM merged commit c9a6f64 into jsdocs-tsdocs Jul 3, 2023
12 checks passed
@HarelM HarelM deleted the js-ts-controls branch July 3, 2023 04:53
HarelM added a commit that referenced this pull request Jul 4, 2023
* Fix some controls

* Replace jsdoc with tsdocs lint

* Fix control's jsdocs

* Improve the looks of the controls

* Fix lint and CI

* Remove the last jsdoc comments in geolocation control
HarelM added a commit that referenced this pull request Jul 8, 2023
* Some examples of conversion

* More experiments

* Fix group name

* Fix lint

* made basic UI changes (#2755)

* Move more comments to their right place

* Remove more tsdocs comments

* Fix lint, complete map jsdocs removal

* Fix lint, remove return types from jsdocs comments.

* Js ts controls (#2777)

* Fix some controls

* Replace jsdoc with tsdocs lint

* Fix control's jsdocs

* Improve the looks of the controls

* Fix lint and CI

* Remove the last jsdoc comments in geolocation control

* Introduce max canvas size option and automatically limit pixel ratio (#2674)

* rendering test: implement cropping of png result

This is useful for renderer results that are too large to be handled by puppeteer

* mock webgl: update drawing buffer size when viewport changes

* Round down painter and canvas dimensions so they're consistent

* add veryhigh pixel ratio test

This test draws a black square,
The pixel ratio and width were chosen to exceed the maximum texture value, which is set to 8192 in the CI environment.
The result is cropped due to the limits of the intercommunication between chromium and puppeteer.

* introduce maxCanvasSize option

A canvas size over GL MAX_TEXTURE_SIZE can cause distortions and an excessive canvas size can cause hangs or crashes.
Limiting canvas size can fix these issues. Add an option to let the users alter this limit.
The default value is [4096, 4096] as MAX_TEXTURE_SIZE is usally at least 4096px.
In CI max_texture_size is 8192, so we set maxCanvasSize to that value in tests.

* Resize map after setting pixel ratio

This has two benefits:
1. The map is immediately re-rendered with the new pixel ratio
2. We avoid duplicating pixel ratio clamping logic

* further clamp pixel ratio after hitting gl limits

Althoug setting maxCanvasSize to a value <= GL.MAX_TEXTURE_SIZE solves most problems, there is no guarantee that we cannot exceed other GL limits.
To handle these cases, we check that the drawing buffer is of the requested size, if it isn't we scale down pixel ratio further

* map test: move webgl error in its own section

* add a unit test for webgl drawing buffer limits

* update maxCanvasSize type and change comment type

* update maxCanvasSize after hitting gl limits

This is an optimization to avoid failing the overlimit check multiple times.

* update changelog

* Added handlers to the docs (#2778)

* Added handlers to the docs

* Fix lint

* Small changes to the docs contribution guide (#2791)

* Changes to docs contribution

* don't link for better review

* Migrated popup and marker (#2790)

* Migrated marker and popup

* Fix lint

* Code review fixes

* Added missing marker options object

* Fix lint and tests

* Fix typo

* remove unneeded lint comment.

* Bump typescript from 5.1.5 to 5.1.6 (#2787)

Bumps [typescript](https://github.com/Microsoft/TypeScript) from 5.1.5 to 5.1.6.
- [Release notes](https://github.com/Microsoft/TypeScript/releases)
- [Commits](https://github.com/Microsoft/TypeScript/commits)

---
updated-dependencies:
- dependency-name: typescript
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* Fix sources (#2795)

* Fix sources

* Added typedoc

* Fix custom style layer

* Fix test, add comments

* fix grammer spelling

* More minor fixes

* JSDocs TSDocs leftovers (#2801)

* insets, lnglat+bounds

* mercator

* transform

* draw_terrain

* line_atlas

* terrain

* tile, styel_image

* actore

* ajax

* image request queue

* struct array

* Remove returns objects

* typedef

* remove function

* Removed some prperties

* Fix lint

* Fix tests

* Lint, cr fixes

* TSDocs JSDocs migration: build warning removal (#2802)

* Added comments to reduce warnings

* Fix most of the warnings in the build process

* TSDocs lint (#2804)

* Move all examples to be tripple slash, hypen, remove @Private

* delimiter fix

* More fixes

* Fix lint

* Remove unneeded rule

* Code review changes.

* Fix var let bad replacenment

* Fix typo

* Fix bwc address

* Small fixes to the event related docs

* Fix lint

* Fix the event related issue

* Added Geography and Geometry group (#2808)

* Added Geography and Geometry

* Fix lint

* Finished the event documentation

* Fix lint

* Main docs readme links fixes and CI (#2813)

* Fix main readme links

* make links relative

* More readme fixes

* Adding build to CI

* Simplify docker commend

* Change site url in the config to match the expected production site.

* Added CI part

* Final small fixes.

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: Krishna Lodha <47075664+krishnaglodha@users.noreply.github.com>
Co-authored-by: Andrea Mennillo <handymenny@outlook.com>
Co-authored-by: Birk Skyum <74932975+birkskyum@users.noreply.github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants