Skip to content

infra: create api.json files for components missing documentation #3627

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

Merged
merged 16 commits into from
Mar 23, 2025

Conversation

devin-ai-integration[bot]
Copy link
Contributor

API JSON files for components missing documentation

This PR adds api.json files for components that were missing documentation.

Change Log

  • Added api.json files for 13 components that were missing documentation
  • Each file includes name, category, description, example, props, and snippet fields

Additional Info

Link to Devin run: https://app.devin.ai/sessions/8268f0e2ac4c4ab0bafc144748b55d3a
Requested by: [email protected]

Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add "(aside)" to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@Inbal-Tish Inbal-Tish self-requested a review March 17, 2025 08:39
Copy link
Contributor Author

This file has already been removed in commit d623f53 along with other internal components marked with displayName = 'IGNORE'.

Copy link
Contributor Author

Removed the duplicate Picker API file as requested.

Copy link
Contributor Author

The ScrollBar API file has already been removed in commit d623f53 as it was identified as an internal component with displayName = 'IGNORE'.

Copy link
Contributor Author

The SharedTransition API file has already been removed in commit d623f53 as it was identified as an internal component with displayName = 'IGNORE'. The sub-components (Area, Source, Target) are also marked as internal components.

Copy link
Contributor Author

The SvgImage API file has already been removed in commit d623f53 as it was identified as an internal component with displayName = 'IGNORE'.

Copy link
Contributor Author

Removed the duplicate TabController API file as requested. It already exists in the apis directory.

Copy link
Contributor Author

Updated the category to 'incubator' for both PanView and ExpandableOverlay components as requested.

Copy link
Contributor Author

The TabController API file has already been removed in commit 340f445 as it was identified as a duplicate of the file in the apis directory.

Copy link
Contributor Author

Restored the ScrollBar API JSON file with a fixed snippet that includes width styling for the View components. The ScrollBar component itself is not marked as internal, only its Item subcomponent is.

Copy link
Contributor Author

Updated the display names and added API JSON files for SharedTransition subcomponents as requested:

  • Changed SharedArea displayName to SharedTransition.Area
  • Changed SourceElement displayName to SharedTransition.Source
  • Changed TargetElement displayName to SharedTransition.Target
  • Added API JSON files for all three subcomponents

Copy link
Contributor Author

Updated the ScrollBar API JSON file as requested:

  • Changed category from 'lists' to 'interaction'
  • Improved the snippet to show multiple items using Array.map for better demonstration of scrollable content

Copy link
Contributor Author

Updated the ScrollBar API JSON snippet to use _.times function as requested instead of Array.fill.map for better readability.

Copy link
Contributor Author

Updated the ScrollBar API JSON category to 'layouts' as requested, using only existing categories.

Copy link
Collaborator

@ethanshar ethanshar left a comment

Choose a reason for hiding this comment

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

@Inbal-Tish
I wrote over each component the reason we don't want to expose except for two components that we can expose
It makes sense these components didn't have api, they weren't missed

Copy link
Collaborator

Choose a reason for hiding this comment

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

Everything under src/components/sharedTransition should not be exposed
It's a component I played with long time ago, not ready in any way for production. I would remove the component

Copy link
Collaborator

Choose a reason for hiding this comment

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

this one we can expose

@@ -0,0 +1,63 @@
{
Copy link
Collaborator

Choose a reason for hiding this comment

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

This is also an infra component, we used internally and it serves other components
but IMO we shouldn't expose it because then we'll have to worry about breaking it

@@ -0,0 +1,56 @@
{
Copy link
Collaborator

Choose a reason for hiding this comment

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

Same as ExpandableOverlay, I remember we didn't want to expose this one

Copy link
Contributor Author

Removed API JSON files for SharedTransition subcomponents and reverted display names to 'IGNORE' as requested.

Copy link
Contributor Author

Removed TextArea API JSON file as requested.

Copy link
Contributor Author

Removed ScrollBar API JSON file as requested.

Copy link
Contributor Author

Removed PanView API JSON file as requested.

Copy link
Contributor Author

Removed ExpandableOverlay API JSON file as requested.

@Inbal-Tish Inbal-Tish merged commit ee4db5e into master Mar 23, 2025
1 check passed
@Inbal-Tish Inbal-Tish deleted the infra/1742196873-create-api-json branch March 23, 2025 07:17
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.

2 participants