Skip to content

feat(dts-gen): add missing kintone JS API type definitions - #3882

Open
shabaraba wants to merge 1 commit into
mainfrom
feat/add-missing-js-api-definitions
Open

feat(dts-gen): add missing kintone JS API type definitions#3882
shabaraba wants to merge 1 commit into
mainfrom
feat/add-missing-js-api-definitions

Conversation

@shabaraba

@shabaraba shabaraba commented Jul 13, 2026

Copy link
Copy Markdown
Member

Why

kintone.d.ts in packages/dts-gen is manually maintained and has fallen significantly behind the JS API published on the Cybozu Developer Network. A cross-reference against the full Cybozu Developer Network JS API index found 90 documented pages with no corresponding type definition (mobile counterparts pushed the real gap well beyond 90 individual functions).

What

Added type definitions for all missing APIs, cross-checked page by page against the Cybozu Developer Network to confirm exact function names, namespaces, and PC/mobile availability:

  • kintone.*: getUserPreference, isUsersAndSystemAdministrator, getAvailableServices, getDomain, getAvailableApiTypes, isAccessWithClientCertificateAuthentication, isMobileApp, isMobilePage, isRevampedUI, getPageType, showConfirmDialog, createDialog, showNotification, showLoading, buildPageUrl, setKeyboardShortcuts, getKeyboardShortcuts
  • kintone.user.* (new namespace): getOrganizations, getGroups, getCustomFields, getIcons
  • kintone.app.*: get, getFormFields, getFormLayout, isTestEnvironment, isMaintenanceMode, showDescription, getDescriptionDisplayState, getIcons, getView, getViews, getReports, getStatus, getCategories, getPermissions, and the show/get-display-state button pairs for add-record / app-settings / options / filter / report / view-and-report-selector / view-selector-items / report-selector-items, plus setRecordListStyle / getRecordListStyle
  • kintone.app.record.*: isGroupFieldOpen, getPermissions, getFieldPermissions, getStatusHistory, getStatusActions, getAssignees, getActions, isFieldVisible, and the show/get-display-state pairs for edit-record / duplicate-record / pager / side-bar / change-assignee / action-button / status-action-button, plus setFieldStyle / getFieldStyle
  • kintone.space.*: get, getPermissions
  • kintone.system.* (new namespace): getAvailableFeatures, getPermissions
  • kintone.license.* (new namespace): isTrial, getSubscriptionPlan
  • kintone.mobile.*: mirrors of all the above where the Cybozu Developer Network documents a separate mobile-only or mobile-mirrored signature (showNotification, showLoading, showConfirmBottomSheet, createBottomSheet, and the mobile.app.* / mobile.app.record.* mirrors)

Type precision: simple types (boolean/string/literal unions) and structurally simple response objects are typed precisely; large free-form objects that mirror the REST API response shape (getFormFields, getFormLayout, getStatus) are typed as any, consistent with the existing style in this file.

How to test

cd packages/dts-gen
pnpm lint:prettier
pnpm test

The new definitions were cross-checked against the full Cybozu Developer Network JS API index and verified with a standalone tsc compile check.

Checklist

  • Read CONTRIBUTING.md
  • Updated documentation if it is required.
  • Added tests if it is required.
  • Passed pnpm lint and pnpm test on the root directory.

Add 90 missing JS API definitions to kintone.d.ts:
- kintone.*: getUserPreference, isUsersAndSystemAdministrator, getAvailableServices,
  getDomain, getAvailableApiTypes, isAccessWithClientCertificateAuthentication,
  isMobileApp, isMobilePage, isRevampedUI, getPageType, showConfirmDialog,
  createDialog, showNotification, showLoading, buildPageUrl,
  setKeyboardShortcuts, getKeyboardShortcuts (17 APIs + mobile variants)
- kintone.user.*: getOrganizations, getGroups, getCustomFields, getIcons (4 APIs, new namespace)
- kintone.app.*: get, getFormFields, getFormLayout, isTestEnvironment,
  isMaintenanceMode, showDescription, getDescriptionDisplayState, getIcons,
  getView, getViews, getReports, getStatus, getCategories, getPermissions,
  showAddRecordButton, getAddRecordButtonDisplayState, showAppSettingsButton,
  getAppSettingsButtonDisplayState, showOptionsButton, getOptionsButtonDisplayState,
  showFilterButton, getFilterButtonDisplayState, showReportButton,
  getReportButtonDisplayState, showViewAndReportSelector,
  getViewAndReportSelectorDisplayState, showViewSelectorItems,
  getViewSelectorItemsDisplayState, showReportSelectorItems,
  getReportSelectorItemsDisplayState, setRecordListStyle, getRecordListStyle (32 APIs)
- kintone.app.record.*: isGroupFieldOpen, getPermissions, getFieldPermissions,
  getStatusHistory, getStatusActions, getAssignees, getActions, isFieldVisible,
  showEditRecordButton, getEditRecordButtonDisplayState, showDuplicateRecordButton,
  getDuplicateRecordButtonDisplayState, showPager, getPagerDisplayState,
  showSideBar, getSideBarDisplayState, showChangeAssigneeButton,
  getChangeAssigneeButtonDisplayState, showActionButton, getActionButtonDisplayState,
  showStatusActionButton, getStatusActionButtonDisplayState,
  setFieldStyle, getFieldStyle (24 APIs)
- kintone.space.*: get, getPermissions (2 APIs)
- kintone.system.*: getAvailableFeatures, getPermissions (2 APIs, new namespace)
- kintone.license.*: isTrial, getSubscriptionPlan (2 APIs, new namespace)
- kintone.mobile.*: showNotification, showLoading, showConfirmBottomSheet,
  createBottomSheet + mirrors of app/record APIs with mobile support
Copilot AI review requested due to automatic review settings July 13, 2026 04:08
@shabaraba
shabaraba requested a review from a team as a code owner July 13, 2026 04:08
@shabaraba
shabaraba requested review from chihiro-adachi and nameless-mc and removed request for a team July 13, 2026 04:08

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot wasn't able to review any files in this pull request.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions github-actions Bot added the pkg: dts-gen @kintone/dts-gen label Jul 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pkg: dts-gen @kintone/dts-gen

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants