@databricks/appkit-ui 0.36.0 → 0.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/CLAUDE.md +3 -2
  2. package/NOTICE.md +1 -0
  3. package/dist/cli/commands/plugin/add-resource/add-resource.js.map +1 -1
  4. package/dist/cli/commands/plugin/create/resource-defaults.js +2 -1
  5. package/dist/cli/commands/plugin/create/resource-defaults.js.map +1 -1
  6. package/dist/cli/commands/plugin/schema-resources.js +34 -51
  7. package/dist/cli/commands/plugin/schema-resources.js.map +1 -1
  8. package/dist/cli/commands/plugin/sync/sync.js +20 -6
  9. package/dist/cli/commands/plugin/sync/sync.js.map +1 -1
  10. package/dist/cli/commands/plugin/validate/validate-manifest.js +71 -157
  11. package/dist/cli/commands/plugin/validate/validate-manifest.js.map +1 -1
  12. package/dist/cli/commands/plugin/validate/validate.js +2 -2
  13. package/dist/cli/commands/plugin/validate/validate.js.map +1 -1
  14. package/dist/cli/commands/setup.js +2 -2
  15. package/dist/cli/commands/setup.js.map +1 -1
  16. package/dist/react/charts/options.js +2 -1
  17. package/dist/react/charts/options.js.map +1 -1
  18. package/dist/react/hooks/index.d.ts +1 -0
  19. package/dist/react/hooks/index.js +1 -0
  20. package/dist/react/hooks/use-mobile.d.ts +5 -0
  21. package/dist/react/hooks/use-mobile.d.ts.map +1 -0
  22. package/dist/react/index.d.ts +2 -1
  23. package/dist/react/index.js +2 -1
  24. package/dist/react/table/data-table.js +2 -2
  25. package/dist/react/table/data-table.js.map +1 -1
  26. package/dist/react/ui/sidebar.js +1 -1
  27. package/dist/schemas/manifest.d.ts +1139 -0
  28. package/dist/schemas/manifest.d.ts.map +1 -0
  29. package/dist/schemas/manifest.js +524 -0
  30. package/dist/schemas/manifest.js.map +1 -0
  31. package/dist/shared/src/plugin.d.ts +1 -0
  32. package/dist/shared/src/plugin.d.ts.map +1 -1
  33. package/dist/shared/src/schemas/manifest.d.ts +1 -0
  34. package/docs/api/appkit/Enumeration.ResourceType.md +1 -1
  35. package/docs/api/appkit/Interface.PluginManifest.md +57 -3
  36. package/docs/api/appkit/Interface.ResourceEntry.md +6 -4
  37. package/docs/api/appkit/Interface.ResourceRequirement.md +7 -61
  38. package/docs/api/appkit/TypeAlias.ResourceFieldEntry.md +6 -0
  39. package/docs/api/appkit/Variable.agents.md +1 -1
  40. package/docs/api/appkit.md +12 -12
  41. package/docs/app-management.md +1 -1
  42. package/docs/development/ai-assisted-development.md +2 -2
  43. package/docs/development/local-development.md +1 -1
  44. package/docs/development/remote-bridge.md +1 -1
  45. package/docs/development/templates.md +118 -12
  46. package/docs/development.md +1 -1
  47. package/docs/plugins/agents.md +8 -4
  48. package/docs/plugins/custom-plugins.md +33 -23
  49. package/docs/plugins/lakebase.md +1 -1
  50. package/docs/plugins/manifest.md +293 -0
  51. package/docs.md +2 -2
  52. package/llms.txt +3 -2
  53. package/package.json +5 -4
  54. package/sbom.cdx.json +1 -1
  55. package/dist/schemas/plugin-manifest.generated.d.ts +0 -182
  56. package/dist/schemas/plugin-manifest.generated.d.ts.map +0 -1
  57. package/dist/schemas/plugin-manifest.schema.json +0 -489
  58. package/dist/schemas/template-plugins.schema.json +0 -113
  59. package/docs/api/appkit/Interface.ResourceFieldEntry.md +0 -82
@@ -1,113 +0,0 @@
1
- {
2
- "$schema": "http://json-schema.org/draft-07/schema#",
3
- "$id": "https://databricks.github.io/appkit/schemas/template-plugins.schema.json",
4
- "title": "AppKit Template Plugins Manifest",
5
- "description": "Aggregated plugin manifest for AppKit templates. Read by Databricks CLI during init to discover available plugins and their resource requirements.",
6
- "type": "object",
7
- "required": ["version", "plugins"],
8
- "properties": {
9
- "$schema": {
10
- "type": "string",
11
- "description": "Reference to the JSON Schema for validation"
12
- },
13
- "version": {
14
- "type": "string",
15
- "enum": ["1.0", "1.1"],
16
- "description": "Schema version for the template plugins manifest"
17
- },
18
- "plugins": {
19
- "type": "object",
20
- "description": "Map of plugin name to plugin manifest with package source",
21
- "additionalProperties": {
22
- "$ref": "#/$defs/templatePlugin"
23
- }
24
- }
25
- },
26
- "additionalProperties": false,
27
- "$defs": {
28
- "templatePlugin": {
29
- "type": "object",
30
- "required": [
31
- "name",
32
- "displayName",
33
- "description",
34
- "package",
35
- "resources"
36
- ],
37
- "description": "Plugin manifest with package source information",
38
- "properties": {
39
- "name": {
40
- "type": "string",
41
- "pattern": "^[a-z][a-z0-9-]*$",
42
- "description": "Plugin identifier. Must be lowercase, start with a letter, and contain only letters, numbers, and hyphens.",
43
- "examples": ["analytics", "server", "my-custom-plugin"]
44
- },
45
- "displayName": {
46
- "type": "string",
47
- "minLength": 1,
48
- "description": "Human-readable display name for UI and CLI",
49
- "examples": ["Analytics Plugin", "Server Plugin"]
50
- },
51
- "description": {
52
- "type": "string",
53
- "minLength": 1,
54
- "description": "Brief description of what the plugin does",
55
- "examples": ["SQL query execution against Databricks SQL Warehouses"]
56
- },
57
- "package": {
58
- "type": "string",
59
- "minLength": 1,
60
- "description": "NPM package name that provides this plugin",
61
- "examples": ["@databricks/appkit", "@my-org/custom-plugin"]
62
- },
63
- "requiredByTemplate": {
64
- "type": "boolean",
65
- "default": false,
66
- "description": "When true, this plugin is required by the template and cannot be deselected during CLI init. The user will only be prompted to configure its resources. When absent or false, the plugin is optional and the user can choose whether to include it."
67
- },
68
- "onSetupMessage": {
69
- "type": "string",
70
- "description": "Message displayed to the user after project initialization. Use this to inform about manual setup steps (e.g. environment variables, resource provisioning)."
71
- },
72
- "stability": {
73
- "type": "string",
74
- "enum": ["beta", "ga"],
75
- "default": "ga",
76
- "description": "Plugin stability level. Beta is heading to GA; APIs may change between minor releases. GA (general availability) follows semver."
77
- },
78
- "resources": {
79
- "type": "object",
80
- "required": ["required", "optional"],
81
- "description": "Databricks resource requirements for this plugin",
82
- "properties": {
83
- "required": {
84
- "type": "array",
85
- "description": "Resources that must be available for the plugin to function",
86
- "items": {
87
- "$ref": "#/$defs/resourceRequirement"
88
- }
89
- },
90
- "optional": {
91
- "type": "array",
92
- "description": "Resources that enhance functionality but are not mandatory",
93
- "items": {
94
- "$ref": "#/$defs/resourceRequirement"
95
- }
96
- }
97
- },
98
- "additionalProperties": false
99
- }
100
- },
101
- "additionalProperties": false
102
- },
103
- "resourceType": {
104
- "$ref": "plugin-manifest.schema.json#/$defs/resourceType"
105
- },
106
- "resourceFieldEntry": {
107
- "$ref": "plugin-manifest.schema.json#/$defs/resourceFieldEntry"
108
- },
109
- "resourceRequirement": {
110
- "$ref": "plugin-manifest.schema.json#/$defs/resourceRequirement"
111
- }
112
- }
113
- }
@@ -1,82 +0,0 @@
1
- # Interface: ResourceFieldEntry
2
-
3
- Defines a single field for a resource. Each field has its own environment variable and optional description. Single-value types use one key (e.g. id); multi-value types (database, secret) use multiple (e.g. instance\_name, database\_name or scope, key).
4
-
5
- This interface was referenced by `PluginManifest`'s JSON-Schema via the `definition` "resourceFieldEntry".
6
-
7
- ## Properties[​](#properties "Direct link to Properties")
8
-
9
- ### bundleIgnore?[​](#bundleignore "Direct link to bundleIgnore?")
10
-
11
- ```ts
12
- optional bundleIgnore: boolean;
13
-
14
- ```
15
-
16
- When true, this field is excluded from Databricks bundle configuration (databricks.yml) generation.
17
-
18
- ***
19
-
20
- ### description?[​](#description "Direct link to description?")
21
-
22
- ```ts
23
- optional description: string;
24
-
25
- ```
26
-
27
- Human-readable description for this field
28
-
29
- ***
30
-
31
- ### env?[​](#env "Direct link to env?")
32
-
33
- ```ts
34
- optional env: string;
35
-
36
- ```
37
-
38
- Environment variable name for this field
39
-
40
- ***
41
-
42
- ### examples?[​](#examples "Direct link to examples?")
43
-
44
- ```ts
45
- optional examples: string[];
46
-
47
- ```
48
-
49
- Example values showing the expected format for this field
50
-
51
- ***
52
-
53
- ### localOnly?[​](#localonly "Direct link to localOnly?")
54
-
55
- ```ts
56
- optional localOnly: boolean;
57
-
58
- ```
59
-
60
- When true, this field is only generated for local .env files. The Databricks Apps platform auto-injects it at deploy time.
61
-
62
- ***
63
-
64
- ### resolve?[​](#resolve "Direct link to resolve?")
65
-
66
- ```ts
67
- optional resolve: string;
68
-
69
- ```
70
-
71
- Named resolver prefixed by resource type (e.g., 'postgres<!-- -->:host<!-- -->'). The CLI resolves this value during the init prompt flow.
72
-
73
- ***
74
-
75
- ### value?[​](#value "Direct link to value?")
76
-
77
- ```ts
78
- optional value: string;
79
-
80
- ```
81
-
82
- Static value for this field. Used when no prompted or resolved value exists.