@malloydata/malloy-explorer 0.0.257-dev250410160631

package/.editorconfig

@@ -0,0 +1,8 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+insert_final_newline = true

package/.github/workflows/prerelease.yaml

@@ -0,0 +1,28 @@
+name: npmjs.com Pre-release
+
+on: [workflow_dispatch]
+
+jobs:
+  test:
+    uses: './.github/workflows/test.yaml'
+
+  npm-prerelease:
+    needs:
+      - test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+      - name: npm install, build, and publish
+        run: |
+          npm ci --loglevel error
+          PRERELEASE=$(date +%y%m%d%H%M%S)
+          VERSION=$(jq -r .version ./package.json)-dev$PRERELEASE
+          npm version --no-git-tag-version $VERSION
+          npm publish --access=public
+        env:
+          CI: true
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/test.yaml

@@ -0,0 +1,26 @@
+name: Test
+
+on:
+  workflow_call:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  test-all:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+      - name: Install
+        run: npm ci --loglevel error
+      - name: Build and Test
+        run: |
+          npm run build
+          npm run lint
+          # npm run test

package/.node-version

@@ -0,0 +1 @@
+20.18.1

package/.prettierrc.js

@@ -0,0 +1,8 @@
+// eslint-disable-next-line no-undef
+module.exports = {
+  arrowParens: 'avoid',
+  bracketSpacing: false,
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'es5',
+};

package/.vscode/extensions.json

@@ -0,0 +1,6 @@
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode"
+  ]
+}

package/@flowtypes/components/MalloyExplorerProvider.flow.js

@@ -0,0 +1,13 @@
+import { ReactNode } from "react";
+import * as Malloy from "@malloydata/malloy-interfaces";
+import { SearchValueMapResult } from "../contexts/QueryEditorContext";
+declare export interface MalloyExplorerProviderProps {
+  source: Malloy.SourceInfo;
+  query?: Malloy.Query;
+  setQuery?: (query: Malloy.Query | void) => void;
+  children: ReactNode | ReactNode[];
+  topValues?: SearchValueMapResult[];
+}
+declare export function MalloyExplorerProvider(
+  $$param0$: MalloyExplorerProviderProps,
+): $Exports<"react/jsx-runtime">["JSX"]["Element"];

package/@flowtypes/components/QueryPanel/QueryActionBar.flow.js

@@ -0,0 +1,10 @@
+import * as Malloy from "@malloydata/malloy-interfaces";
+declare export interface QueryActionBarProps {
+  source: Malloy.SourceInfo;
+  query?: Malloy.Query;
+  clearQuery: () => void;
+  runQuery: (source: Malloy.SourceInfo, query: Malloy.Query) => void;
+}
+declare export function QueryActionBar(
+  $$param0$: QueryActionBarProps,
+): $Exports<"react/jsx-runtime">["JSX"]["Element"];

package/@flowtypes/components/QueryPanel/QueryEditor.flow.js

@@ -0,0 +1,9 @@
+import * as Malloy from "@malloydata/malloy-interfaces";
+declare export interface QueryEditorProps {
+  source: Malloy.SourceInfo;
+  query?: Malloy.Query;
+  setQuery?: (query: Malloy.Query | void) => void;
+}
+declare export function QueryEditor(
+  $$param0$: QueryEditorProps,
+): $Exports<"react/jsx-runtime">["JSX"]["Element"] | null;

package/@flowtypes/components/ResultPanel/ResultPanel.flow.js

@@ -0,0 +1,14 @@
+import * as Malloy from "@malloydata/malloy-interfaces";
+import { SubmittedQuery } from "./SubmittedQuery";
+type ResultPanelOptions = { showRawQuery: boolean, ... };
+declare export interface ResultPanelProps {
+  source: Malloy.SourceInfo;
+  draftQuery?: Malloy.Query;
+  setDraftQuery: (query: Malloy.Query) => void;
+  submittedQuery?: SubmittedQuery;
+  options?: ResultPanelOptions;
+}
+declare export default function ResultPanel(
+  $$param0$: ResultPanelProps,
+): $Exports<"react/jsx-runtime">["JSX"]["Element"];
+declare export {};

package/@flowtypes/components/ResultPanel/SubmittedQuery.flow.js

@@ -0,0 +1,32 @@
+import * as Malloy from "@malloydata/malloy-interfaces";
+import { ExplorerError } from "../../types/error";
+declare export const EXECUTION_STATES: {
+  compiling: string,
+  running: string,
+  finished: string,
+  canceled: string,
+  ...
+};
+export type QueryExecutionState = keyof typeof EXECUTION_STATES;
+export type SubmittedQuery = {
+  query: Malloy.Query,
+  executionState: QueryExecutionState,
+  queryResolutionStartMillis: number,
+  onCancel: () => void,
+  response?: QueryResponse,
+  ...
+};
+export type RunStats = {
+  compileTime: number,
+  runTime: number,
+  rowsProcessed: number,
+  peakMemory: number,
+  queryId: string,
+  ...
+};
+export type QueryResponse = {
+  error?: ExplorerError,
+  result?: Malloy.Result,
+  runStats?: RunStats,
+  ...
+};

package/@flowtypes/components/SourcePanel/SourcePanel.flow.js

@@ -0,0 +1,9 @@
+import * as Malloy from "@malloydata/malloy-interfaces";
+declare export interface SourcePanelProps {
+  source: Malloy.SourceInfo;
+  query?: Malloy.Query;
+  setQuery: (query: Malloy.Query | void) => void;
+}
+declare export function SourcePanel(
+  $$param0$: SourcePanelProps,
+): $Exports<"react/jsx-runtime">["JSX"]["Element"] | null;

package/@flowtypes/contexts/ExplorerPanelsContext.flow.js

@@ -0,0 +1,6 @@
+import * as React from "react";
+declare export interface ExplorerPanelsContextProps {
+  isSourcePanelOpen: boolean;
+  setIsSourcePanelOpen?: (isOpen: boolean) => void;
+}
+declare export const ExplorerPanelsContext: React.Context<ExplorerPanelsContextProps>;

package/@flowtypes/index.flow.js

@@ -0,0 +1,18 @@
+import "./stylex.css";
+declare export { MalloyExplorerProvider } from "./components/MalloyExplorerProvider";
+declare export {
+  QueryActionBar,
+  QueryEditor,
+  QueryPanel,
+} from "./components/QueryPanel";
+declare export { ResultPanel } from "./components/ResultPanel";
+declare export {
+  EXECUTION_STATES,
+  QueryExecutionState,
+  QueryResponse,
+  RunStats,
+  SubmittedQuery,
+} from "./components/ResultPanel/SubmittedQuery";
+declare export { SourcePanel } from "./components/SourcePanel";
+declare export { ResizeBar } from "./components/primitives";
+declare export { ExplorerPanelsContext } from "./contexts/ExplorerPanelsContext";

package/CONTRIBUTING.md

@@ -0,0 +1,44 @@
+## Project Committers
+
+Our committers are the following GitHub accounts:
+
+lloydtabb
+mtoy-googly-moogly
+carlineng
+christopherswenson
+nachoarreola
+skokenes
+whscullin
+
+## Developer Certificate of Origin
+
+All new inbound code contributions must also be accompanied by a Developer
+Certificate of Origin (http://developercertificate.org) sign-off in the source
+code system that is submitted through a TSC-approved contribution process which
+will bind the authorized contributor and, if not self-employed, their employer
+to the applicable license.
+
+Contributors sign-off that they adhere to these requirements by adding a
+Signed-off-by line to commit messages.
+
+Git has a -s command line option to append this automatically to your commit
+message, for example:
+
+```
+$ git commit -s -m 'This is my commit message'
+```
+
+## Code Reviews
+
+All submissions, including submissions by project members, require review. We
+use GitHub pull requests for this purpose. Consult
+[GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
+information on using pull requests.
+
+All pull requests must pass tests. Outside contributors should contact the Malloy
+team via the`#developing` channel on the [Malloy Slack](https://malloydata.github.io/slack).
+
+## Code of Conduct
+
+This project follows
+[The Linux Foundation's Code of Conduct](https://lfprojects.org/policies/code-of-conduct/).

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the " Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# Development directions
+
+- Install required packages
+
+```
+npm install
+```
+
+- To test, run the vite developer tool
+
+```
+npm run dev
+```
+
+- Open http://localhost:5173/
+
+## Running against a local version of Malloy
+
+1. Run `npm run malloy-build-and-link` once and whenever you need to pull in changes
+2. If you need to pull in changes of `@malloydata/malloy-render`, then navigate to the `malloy` direcory and build it using `npm run build` first.
+3. If you make changes to Malloy that are required by the explorer, then merge those into main, and that will trigger an automatic developer release of Malloy.
+4. Once that release completes, run `npm run malloy-update` to update dependencies to that release. This will break the link to your local version of Malloy, so if you want to resume local development, re-run `npm run malloy-link`
+5. To manually unlink without updating, you may run `npm run malloy-unlink`

package/babel.config.mjs

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ */
+
+import * as process from 'process';
+import * as path from 'path';
+import {fileURLToPath} from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export default {
+  presets: [['@babel/preset-react', {runtime: 'automatic'}]],
+  plugins: [
+    ['@babel/plugin-syntax-typescript', {isTSX: true}],
+    [
+      '@stylexjs/babel-plugin',
+      {
+        dev: process.env.NODE_ENV === 'development',
+        runtimeInjection: false,
+        genConditionalClasses: true,
+        treeshakeCompensation: true,
+        unstable_moduleResolution: {
+          type: 'commonJS',
+          rootDir: __dirname,
+        },
+      },
+    ],
+  ],
+};